SiteMapNodeCollection.AddRange Method (SiteMapNodeCollection)

 

Adds the nodes in the specified SiteMapNodeCollection to the current collection.

Namespace:   System.Web
Assembly:  System.Web (in System.Web.dll)

Public Overridable Sub AddRange (
	value As SiteMapNodeCollection
)

Parameters

value
Type: System.Web.SiteMapNodeCollection

A SiteMapNodeCollection that contains the SiteMapNode objects to add to the current SiteMapNodeCollection.

Exception Condition
ArgumentException

value is null.

NotSupportedException

The SiteMapNodeCollection is read-only.

The SiteMapNodeCollection collection that is passed to the AddRange method can contain nullSiteMapNode objects; however, this leads to unexpected exceptions when the SiteMapNodeCollection is manipulated.

You cannot add a SiteMapNode object to a read-only or fixed-size SiteMapNodeCollection. You can test whether a SiteMapNodeCollection is read-only by checking the IsReadOnly property.

The following code example demonstrates how to create a modifiable SiteMapNodeCollection collection, and then add SiteMapNode objects to it using the AddRange method.


' Create a SiteMapNodeCollection with all the nodes
' from the first two hierarchical levels of the current
' site map.
Dim baseCollection As SiteMapNodeCollection
baseCollection = New SiteMapNodeCollection(SiteMap.RootNode)

Dim childCollection As SiteMapNodeCollection = SiteMap.RootNode.ChildNodes

baseCollection.AddRange(childCollection)

Response.Write( "<BR>Derived SiteMapNodeCollection.<BR><HR><BR>")

For Each node In baseCollection
    Response.Write( node.Title + "<BR>")
Next

.NET Framework
Available since 2.0
Return to top
Show: