SiteMapNodeCollection Class
Provides a strongly typed collection for SiteMapNode objects and implements the IHierarchicalEnumerable interface to support navigating through the collection.
Assembly: System.Web (in System.Web.dll)
| Name | Description | |
|---|---|---|
 | SiteMapNodeCollection() | Initializes a new instance of the SiteMapNodeCollection class, which is the default instance. |
| SiteMapNodeCollection(Int32) | Initializes a new instance of the SiteMapNodeCollection class with the specified initial capacity. |
| SiteMapNodeCollection(SiteMapNode^) | Initializes a new instance of the SiteMapNodeCollection class and adds the SiteMapNode object to the InnerList property for the collection. |
| SiteMapNodeCollection(array<SiteMapNode^>^) | Initializes a new instance of the SiteMapNodeCollection class and adds the array of type SiteMapNode to the InnerList property for the collection. |
| SiteMapNodeCollection(SiteMapNodeCollection^) | Initializes a new instance of the SiteMapNodeCollection class and adds all the list items of the specified SiteMapNodeCollection collection to the InnerList property for the collection. |
| Name | Description | |
|---|---|---|
 | Count | Gets the number of elements contained in the collection. |
| IsFixedSize | Gets a Boolean value indicating whether nodes can be added to or subtracted from the collection. |
| IsReadOnly | Gets a Boolean value indicating whether the collection is read-only. |
| IsSynchronized | Gets a Boolean value indicating whether access to the collection is synchronized (thread safe). |
| Item[Int32] | Gets or sets the SiteMapNode object at the specified index in the collection. |
| SyncRoot | Gets an object that can be used to synchronize access to the collection. |
| Name | Description | |
|---|---|---|
| Add(SiteMapNode^) | Adds a single SiteMapNode object to the collection. |
| AddRange(array<SiteMapNode^>^) | Adds an array of type SiteMapNode to the collection. |
| AddRange(SiteMapNodeCollection^) | Adds the nodes in the specified SiteMapNodeCollection to the current collection. |
| Clear() | Removes all items from the collection. |
| Contains(SiteMapNode^) | Determines whether the collection contains a specific SiteMapNode object. |
| CopyTo(array<SiteMapNode^>^, Int32) | Copies the entire collection to a compatible one-dimensional array, starting at the specified index of the target array. |
| Equals(Object^) | Determines whether the specified object is equal to the current object.(Inherited from Object.) |
 | Finalize() | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.) |
| GetDataSourceView(SiteMapDataSource^, String^) | Retrieves the SiteMapDataSourceView object that is associated with the nodes in the current collection. |
| GetEnumerator() | Retrieves a reference to an enumerator object, which is used to iterate over the collection. |
| GetHashCode() | Serves as the default hash function. (Inherited from Object.) |
| GetHierarchicalDataSourceView() | Retrieves the SiteMapHierarchicalDataSourceView object that is associated with the nodes in the current collection. |
| GetHierarchyData(Object^) | Returns a hierarchical data item for the specified enumerated item. |
| GetType() | |
| IndexOf(SiteMapNode^) | Searches for the specified SiteMapNode object, and then returns the zero-based index of the first occurrence within the entire collection. |
| Insert(Int32, SiteMapNode^) | Inserts the specified SiteMapNode object into the collection at the specified index. |
| MemberwiseClone() | |
| OnValidate(Object^) | Performs additional custom processes when validating a value. |
 | ReadOnly(SiteMapNodeCollection^) | Returns a read-only collection that contains the nodes in the specified SiteMapNodeCollection collection. |
| Remove(SiteMapNode^) | Removes the specified SiteMapNode object from the collection. |
| RemoveAt(Int32) | Removes the SiteMapNode object at the specified index of the collection. |
| ToString() | Returns a string that represents the current object.(Inherited from Object.) |
| Name | Description | |
|---|---|---|
  | ICollection::CopyTo(Array^, Int32) | This API supports the product infrastructure and is not intended to be used directly from your code. Copies the elements of the ICollection interface to an array, starting at a particular array index. This class cannot be inherited. |
| IEnumerable::GetEnumerator() | This API supports the product infrastructure and is not intended to be used directly from your code. Returns an enumerator that iterates through a collection. For a description of this member, see IEnumerable::GetEnumerator. |
| IList::Add(Object^) | This API supports the product infrastructure and is not intended to be used directly from your code. Adds an item to the collection in the IList interface. For a description of this member, see IList::Add. |
| IList::Clear() | This API supports the product infrastructure and is not intended to be used directly from your code. Removes all items from the collection in the IList interface. For a description of this member, see IList::Clear. |
| IList::Contains(Object^) | Determines whether the collection in the IList interface contains the specified Boolean value. |
| IList::IndexOf(Object^) | This API supports the product infrastructure and is not intended to be used directly from your code. Determines the index of the specific item in the collection that is returned by the IList interface. For a description of this member, see IList::IndexOf. |
| IList::Insert(Int32, Object^) | This API supports the product infrastructure and is not intended to be used directly from your code. Inserts an item into the collection in the IList interface at the specified index. For a description of this member, see IList::Insert. |
| IList::Remove(Object^) | This API supports the product infrastructure and is not intended to be used directly from your code. Removes the first occurrence of a specified object from the collection in the IList interface. For a description of this member, see IList::Remove. |
| IList::RemoveAt(Int32) | This API supports the product infrastructure and is not intended to be used directly from your code. Removes the IList item at the specified index. For a description of this member, see IList::RemoveAt. |
| IHierarchicalEnumerable::GetHierarchyData(Object^) | This API supports the product infrastructure and is not intended to be used directly from your code. Returns a hierarchical data item for the specified enumerated item. For a description of this member, see IHierarchicalEnumerable::GetHierarchyData. |
 | ICollection::Count | This API supports the product infrastructure and is not intended to be used directly from your code. Gets the number of elements that are contained in the ICollection interface. This class cannot be inherited. |
| ICollection::IsSynchronized | This API supports the product infrastructure and is not intended to be used directly from your code. Gets a Boolean value indicating whether access to the ICollection interface is synchronized (thread safe). This class cannot be inherited. |
| ICollection::SyncRoot | This API supports the product infrastructure and is not intended to be used directly from your code. Gets an object that can be used to synchronize access to the ICollection interface. This class cannot be inherited. |
| IList::IsFixedSize | This API supports the product infrastructure and is not intended to be used directly from your code. Gets a Boolean value indicating whether the collection has a fixed size. For a description of this member, see IList::IsFixedSize. |
| IList::IsReadOnly | This API supports the product infrastructure and is not intended to be used directly from your code. Gets a Boolean value indicating whether the collection is read-only. For a description of this member, see IList::IsReadOnly. |
| IList::Item[Int32] | This API supports the product infrastructure and is not intended to be used directly from your code. Gets the IList element at the specified index. |
| Name | Description | |
|---|---|---|
| AsParallel() | Overloaded. Enables parallelization of a query.(Defined by ParallelEnumerable.) |
| AsQueryable() | Overloaded. Converts an IEnumerable to an IQueryable.(Defined by Queryable.) |
| Cast<TResult>() | Casts the elements of an IEnumerable to the specified type.(Defined by Enumerable.) |
| OfType<TResult>() | Filters the elements of an IEnumerable based on a specified type.(Defined by Enumerable.) |
The SiteMapNodeCollection class provides a strongly typed collection for SiteMapNode objects. It stores SiteMapNode objects internally in a zero-based array.
You can modify a SiteMapNodeCollection collection when it is first created, and then use the following methods to add, copy, and remove SiteMapNode objects:
To add SiteMapNode objects, use the Add, AddRange, and Insert methods.
To copy SiteMapNode objects, use the CopyTo method.
To remove SiteMapNode objects, use the Remove method.
You can create a read-only SiteMapNodeCollection, which does not permit adding, copying, nor removing SiteMapNode objects, by using the static ReadOnly method. The SiteMapNodeCollection collections that are returned by the SiteMapNode::GetAllNodes and GetChildren methods are read-only, as is the SiteMapNodeCollection that is returned when the ChildNodes property is accessed on a SiteMapNode object that is returned from a provider. A NotSupportedException exception is thrown, if you attempt to modify a read-only SiteMapNodeCollection by setting the default indexer property or by using any of the following methods:
Use the IsReadOnly property to check the collection before calling any of the methods in the preceding list.
The following code example demonstrates how to create a SiteMapNodeCollection collection, and then add SiteMapNode objects to it using the AddRange method. The SiteMapNodeCollection is a subset of the current site map, showing only the first two hierarchical levels.
Available since 2.0
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.