AdvisableHashSet<T> Class
A collection type similar to System.Collections.Generic.HashSet<> into which advices can be injected dynamically.
Implements
Namespace: PostSharp.Patterns.Collections
Assembly: PostSharp.Patterns.Common.dll
Syntax
public class AdvisableHashSet<T> : DynamicallyAdvisableObject, IDynamicallyAdvisableHashSet, IDynamicallyAdvisable, IQueryInterfaceType Parameters
| Name | Description |
|---|---|
| T | The type of elements in the collection |
Remarks
The API of this class is compatible with the System.Collections.Generic.HashSet<> class. It provides some additions but preserves the same design and naming conventions.
Classes that derive from System.Collections.Generic.HashSet<> 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 AddItem(T).
Public methods should not use other public methods of the class, as it may cause inconsistent invocation of advises and performance issues.
Constructors
| Name | Description |
|---|---|
| AdvisableHashSet() | Initializes a new instance of the AdvisableHashSet<T> class that is empty and uses the default equality comparer for the set type. |
| AdvisableHashSet(IEnumerable<T>) | Initializes a new instance of the AdvisableHashSet<T> class that uses the default equality comparer for the set type, contains elements copied from the specified collection, and has sufficient capacity to accommodate the number of elements copied. |
| AdvisableHashSet(IEnumerable<T>, IEqualityComparer<T>) | Initializes a new instance of the AdvisableHashSet<T> class that uses the specified equality comparer for the set type, contains elements copied from the specified collection, and has sufficient capacity to accommodate the number of elements copied. |
| AdvisableHashSet(IEqualityComparer<T>) | Initializes a new instance of the AdvisableHashSet<T> class that is empty and uses the specified equality comparer for the set type. |
| AdvisableHashSet(SerializationInfo, StreamingContext) |
Properties
| Name | Description |
|---|---|
| Comparer | Gets the System.Collections.Generic.IEqualityComparer<> object that is used to determine equality for the values in the set. |
| Count |
Methods
| Name | Description |
|---|---|
| Add(T) | |
| AddItem(T) | Inserts an element into the underlying set. |
| ChangeManyItems(IList<T>, IList<T>) | Modifies the underlying set by adding and removing the specified items. |
| Clear() | |
| ClearItems() | Removes all elements from the underlying set. |
| Contains(T) | |
| CopyTo(T[]) | Copies the elements of an AdvisableHashSet<T> object to an array. |
| CopyTo(T[], Int32) | |
| CopyTo(T[], Int32, Int32) | Copies the specified number of elements of an AdvisableHashSet<T> object to an array, starting at the specified array index. |
| CreateSetComparer() | Returns an IEqualityComparer object that can be used for equality testing of a AdvisableHashSet<T> object. |
| ExceptWith(IEnumerable<T>) | |
| GetAdviceEnumerator() | Gets an AdviceEnumerator<T> for the ICollectionDynamicAdvice<T> interface. |
| GetEnumerator() | Returns an enumerator that iterates through the AdvisableHashSet<T>. |
| GetObjectData(SerializationInfo, StreamingContext) | |
| IntersectWith(IEnumerable<T>) | |
| IsProperSubsetOf(IEnumerable<T>) | |
| IsProperSupersetOf(IEnumerable<T>) | |
| IsSubsetOf(IEnumerable<T>) | |
| IsSupersetOf(IEnumerable<T>) | |
| OnDeserialization(Object) | |
| Overlaps(IEnumerable<T>) | |
| Remove(T) | |
| RemoveItem(T) | Removes an element from the underlying collection. |
| RemoveWhere(Predicate<T>) | Removes all elements that match the conditions defined by the specified predicate from a System.Collections.Generic.HashSet<> collection. |
| SetEquals(IEnumerable<T>) | |
| SymmetricExceptWith(IEnumerable<T>) | |
| TrimExcess() | Sets the capacity of a AdvisableHashSet<T> object to the actual number of elements it contains, rounded up to a nearby, implementation-specific value. |
| UnionWith(IEnumerable<T>) |
Explicit Interface Implementations
| Name | Description |
|---|---|
| IDynamicallyAdvisableHashSet.ItemType | Gets the type of items in the collection. |