This documentation is archived and is not being maintained.

SiteMapNodeCollection.AddRange Method (SiteMapNodeCollection)

Note: This method is new in the .NET Framework version 2.0.

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
)
public void AddRange (
	SiteMapNodeCollection value
)
public function AddRange (
	value : SiteMapNodeCollection
)

Parameters

value

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

Exception typeCondition

ArgumentException

value is a null reference (Nothing in Visual Basic).

NotSupportedException

The SiteMapNodeCollection is read-only.

The SiteMapNodeCollection collection that is passed to the AddRange method can contain a null reference (Nothing in Visual Basic)SiteMapNode 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 =
    SiteMap.RootNode.ChildNodes;

baseCollection.AddRange(childCollection);

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

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: