Export (0) Print
Expand All

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

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 Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2014 Microsoft