Open sandboxFocus
  • TOC

Post­Sharp Documentation

Introduction

Deployment and Configuration

Adding Aspects to Code

Logging

Contracts

INotify­Property­Changed

Weak Event

XAML

Parent/Child, Visitor and Disposable

Undo/Redo

Caching

Multithreading

Developing Custom Aspects

Validating Architecture

Testing and Debugging

Miscellaneous

API Reference

Post­Sharp

Post­Sharp.​Aspects

Post­Sharp.​Aspects.​Advices

Post­Sharp.​Aspects.​Configuration

Post­Sharp.​Aspects.​Dependencies

Post­Sharp.​Aspects.​Internals

Post­Sharp.​Aspects.​Serialization

Post­Sharp.​Collections

Post­Sharp.​Constraints

Post­Sharp.​Extensibility

Post­Sharp.​Extensibility.​Build­Time­Logging

Post­Sharp.​Patterns

Post­Sharp.​Patterns.​Caching

Post­Sharp.​Patterns.​Caching.​Backends

Post­Sharp.​Patterns.​Caching.​Backends.​Azure

Post­Sharp.​Patterns.​Caching.​Backends.​Redis

Post­Sharp.​Patterns.​Caching.​Dependencies

Post­Sharp.​Patterns.​Caching.​Formatters

Post­Sharp.​Patterns.​Caching.​Implementation

Post­Sharp.​Patterns.​Caching.​Locking

Post­Sharp.​Patterns.​Caching.​Serializers

Post­Sharp.​Patterns.​Caching.​Value­Adapters

Post­Sharp.​Patterns.​Collections

Post­Sharp.​Patterns.​Collections.​Advices

Post­Sharp.​Patterns.​Contracts

Post­Sharp.​Patterns.​Diagnostics

Post­Sharp.​Patterns.​Diagnostics.​Adapters.​Asp­Net­Core

Post­Sharp.​Patterns.​Diagnostics.​Adapters.​Asp­Net­Framework

Post­Sharp.​Patterns.​Diagnostics.​Adapters.​Diagnostic­Source

Post­Sharp.​Patterns.​Diagnostics.​Adapters.​Http­Client

Post­Sharp.​Patterns.​Diagnostics.​Audit

Post­Sharp.​Patterns.​Diagnostics.​Backends

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Application­Insights

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Audit

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Common­Logging

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Console

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Event­Source

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Log4Net

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Microsoft

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Multiplexer

Post­Sharp.​Patterns.​Diagnostics.​Backends.​NLog

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Null

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Serilog

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Trace

Post­Sharp.​Patterns.​Diagnostics.​Backends.​Trace­Source

Post­Sharp.​Patterns.​Diagnostics.​Contexts

Post­Sharp.​Patterns.​Diagnostics.​Correlation

Post­Sharp.​Patterns.​Diagnostics.​Custom

Post­Sharp.​Patterns.​Diagnostics.​Custom.​Messages

Post­Sharp.​Patterns.​Diagnostics.​Formatters

Post­Sharp.​Patterns.​Diagnostics.​Record­Builders

Post­Sharp.​Patterns.​Diagnostics.​Threading­Instrumentation

Post­Sharp.​Patterns.​Diagnostics.​Transactions

Post­Sharp.​Patterns.​Diagnostics.​Transactions.​Model

Post­Sharp.​Patterns.​Dynamic­Advising

Post­Sharp.​Patterns.​Formatters

Post­Sharp.​Patterns.​Model

Post­Sharp.​Patterns.​Model.​Controls

Post­Sharp.​Patterns.​Model.​Type­Adapters

Post­Sharp.​Patterns.​Recording

Post­Sharp.​Patterns.​Recording.​Operations

Post­Sharp.​Patterns.​Threading

Post­Sharp.​Patterns.​Threading.​Models

Post­Sharp.​Patterns.​Utilities

Post­Sharp.​Patterns.​Xaml

Post­Sharp.​Reflection

Post­Sharp.​Reflection.​Method­Body

Post­Sharp.​Serialization

  • Article

Class AdvisableCollection<T>

A collection type similar to Collection<T> into which advices can be injected dynamically.

Namespace: PostSharp.Patterns.Collections
Assembly: PostSharp.Patterns.Common.dll
Syntax
public class AdvisableCollection<T> : DynamicallyAdvisableObject, ISerializable, IDeserializationCallback, IList<T>, ICollection<T>, IList, IDynamicallyAdvisableCollection, ICollection, IDynamicallyAdvisable, IQueryInterface, INotifyPropertyChanged, IReadOnlyList<T>, IReadOnlyCollection<T>, IEnumerable<T>, IEnumerable, INotifyCollectionChanged
Type Parameters
Name Description
T

The type of elements in the collection

Remarks

The API of this class is compatible with the Collection<T> class. It provides some additions but preserves the same design and naming conventions.

Classes that derive from AdvisableCollection<T> can add functionalities by overriding protected methods or by defining new public methods. New public methods wrap their logic in a call of the ExecuteWithAdvices<TResult, TAction>(ObjectAccessLevel, ref TAction) method, which applies boundary aspects. Public methods can access the data structure thanks to protected methods, which have a name ending in Item, for instance SetItem(int, T). Public methods should not use other public methods of the class, as it may cause inconsistent invocation of advises and performance issues. Events (PropertyChanged and CollectionChanged( are buffered. Public methods must invoke RaiseEvents() to raise buffered events.

Constructors

Name Description
AdvisableCollection()

Initializes a new instance of the AdvisableCollection<T> class that is empty and has the default initial capacity.

AdvisableCollection(IEnumerable<T>)

Initializes a new instance of the AdvisableCollection<T> class that contains elements copied from the specified collection and has sufficient capacity to accommodate the number of elements copied.

AdvisableCollection(int)

Initializes a new instance of the AdvisableCollection<T> class that is empty and has the specified initial capacity.

Properties

Name Description
Count
IsReadOnly
this[int]

Methods

Name Description
Add(T)
AddRange(IEnumerable<T>)

Adds the elements of the specified collection to the end of the AdvisableCollection<T>.

Clear()
ClearItems()

Removes all elements from the underlying collection.

Contains(T)
CopyTo(T[], int)
GetAdviceEnumerator()

Gets an AdviceEnumerator<T> for the ICollectionDynamicAdvice<T> interface.

GetCount()

Gets the number of elements in the underlying collection.

GetEnumerator()

Returns an enumerator that iterates through the AdvisableCollection<T>.

GetItem(int)

Gets the element at the specified index of the underlying collection.

GetObjectData(SerializationInfo, StreamingContext)
GetRange(int, int)

Creates a shallow copy of a range of elements in the source AdvisableCollection<T>.

IndexOf(T)
IndexOfItem(T)

Searches for the specified object and returns the zero-based index of the first occurrence within the entire underlying collection.

Insert(int, T)
InsertItem(int, T)

Inserts an element into the underlying collection at the specified index.

InsertItems(int, T[])

Inserts elements into the underlying collection at the specified index.

InsertRange(int, IEnumerable<T>)

Inserts the elements of a collection into the AdvisableCollection<T> at the specified index.

Move(int, int)

Moved the element at the specified index to another index.

MoveItem(T, int, int)

Moves the element at the specified index to another index in the underlying collection.

OnDeserialization(object)
RaiseEvents()

Raised the events that have been buffered.

Remove(T)
RemoveAt(int)
RemoveItem(int)

Removes the element at the specified index of the underlying collection.

RemoveItems(int, int)

Removes the specified number of elements starting at the specified index of the underlying collection.

RemoveRange(int, int)

Removes a range of elements from the AdvisableCollection<T>.

SetItem(int, T)

Replaces the element at the specified index of the underlying collection.

ToArray()

Creates an array from the current AdvisableCollection<T>.

Events

Name Description
CollectionChanged
PropertyChanged

Event raised when the value of a property of the current object changes.

Extension Methods