SiteMapNodeCollection.AddRange Method (SiteMapNodeCollection)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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

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

public virtual void AddRange(
	SiteMapNodeCollection value


Type: System.Web.SiteMapNodeCollection

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

Exception Condition

value is null.


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.
SiteMapNodeCollection baseCollection =
    new SiteMapNodeCollection(SiteMap.RootNode);

SiteMapNodeCollection childCollection =


Response.Write( "<BR>Derived SiteMapNodeCollection.<BR><HR><BR>");
foreach (SiteMapNode node in baseCollection) {
    Response.Write( node.Title + "<BR>");

.NET Framework
Available since 2.0
Return to top