SiteMapNodeCollection コンストラクター

定義

SiteMapNodeCollection クラスの新しいインスタンスを初期化します。Initializes a new instance of the SiteMapNodeCollection class.

オーバーロード

SiteMapNodeCollection()

SiteMapNodeCollection クラスの新しいインスタンスを初期化します。これが既定のインスタンスです。Initializes a new instance of the SiteMapNodeCollection class, which is the default instance.

SiteMapNodeCollection(Int32)

指定した初期量を使用して、SiteMapNodeCollection クラスの新しいインスタンスを初期化します。Initializes a new instance of the SiteMapNodeCollection class with the specified initial capacity.

SiteMapNodeCollection(SiteMapNode)

SiteMapNodeCollection クラスの新しいインスタンスを初期化して、SiteMapNode オブジェクトをコレクションの InnerList プロパティに追加します。Initializes a new instance of the SiteMapNodeCollection class and adds the SiteMapNode object to the InnerList property for the collection.

SiteMapNodeCollection(SiteMapNode[])

SiteMapNodeCollection クラスの新しいインスタンスを初期化して、SiteMapNode 型の配列をコレクションの InnerList プロパティに追加します。Initializes a new instance of the SiteMapNodeCollection class and adds the array of type SiteMapNode to the InnerList property for the collection.

SiteMapNodeCollection(SiteMapNodeCollection)

SiteMapNodeCollection クラスの新しいインスタンスを初期化して、指定した SiteMapNodeCollection コレクションのリスト項目をすべてコレクションの InnerList プロパティに追加します。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.

SiteMapNodeCollection()

SiteMapNodeCollection クラスの新しいインスタンスを初期化します。これが既定のインスタンスです。Initializes a new instance of the SiteMapNodeCollection class, which is the default instance.

public:
 SiteMapNodeCollection();
public SiteMapNodeCollection ();
Public Sub New ()

次のコード例は、SiteMapNodeCollection コンストラクターを使用して新しい SiteMapNodeCollection コレクションを作成し、Add メソッドを使用して SiteMapNodeCollection に要素を追加する方法を示しています。The following code example demonstrates how to use the SiteMapNodeCollection constructor to create a new SiteMapNodeCollection collection, and then add elements to the SiteMapNodeCollection with the Add method.

// The LoadSiteMapData() method loads site navigation
// data from persistent storage into a DataTable.
DataTable siteMap = LoadSiteMapData();

// Create a SiteMapNodeCollection.
SiteMapNodeCollection nodes = new SiteMapNodeCollection();

// Create a SiteMapNode and add it to the collection.
SiteMapNode tempNode;
DataRow row;
int index = 0;

while (index < siteMap.Rows.Count)
{

    row = siteMap.Rows[index];

    // Create a node based on the data in the DataRow.
    tempNode = new SiteMapNode(SiteMap.Provider,
                                row["Key"].ToString(),
                                row["Url"].ToString());

    // Add the node to the collection.
    nodes.Add(tempNode);
    ++index;
}
' The LoadSiteMapData() Function loads site navigation
' data from persistent storage into a DataTable.

Dim siteMapData As DataTable
siteMapData = LoadSiteMapData()

' Create a SiteMapNodeCollection.
Dim nodes As New SiteMapNodeCollection()

' Create a SiteMapNode and add it to the collection.
Dim tempNode As SiteMapNode
Dim row As DataRow
Dim index As Integer
index = 0

While (index < siteMapData.Rows.Count)

    row = siteMapData.Rows(index)

    ' Create a node based on the data in the DataRow.
    tempNode = New SiteMapNode(SiteMap.Provider, row("Key").ToString(), row("Url").ToString())

    ' Add the node to the collection.
    nodes.Add(tempNode)
    index = index + 1
End While

注釈

SiteMapNodeCollection コンストラクターを使用して、空の SiteMapNodeCollection コレクションを作成します。Use the SiteMapNodeCollection constructor to create an empty SiteMapNodeCollection collection. AddAddRange、または Insert メソッドを使用して、SiteMapNodeCollection に要素を追加できます。You can add elements to the SiteMapNodeCollection using the Add, AddRange, or Insert method.

こちらもご覧ください

SiteMapNodeCollection(Int32)

指定した初期量を使用して、SiteMapNodeCollection クラスの新しいインスタンスを初期化します。Initializes a new instance of the SiteMapNodeCollection class with the specified initial capacity.

public:
 SiteMapNodeCollection(int capacity);
public SiteMapNodeCollection (int capacity);
new System.Web.SiteMapNodeCollection : int -> System.Web.SiteMapNodeCollection
Public Sub New (capacity As Integer)

パラメーター

capacity
Int32

SiteMapNodeCollection の初期量。The initial capacity of the SiteMapNodeCollection.

注釈

SiteMapNodeCollection コンストラクターを使用して、指定した初期量の SiteMapNodeCollection コレクションを作成します。Use the SiteMapNodeCollection constructor to create a SiteMapNodeCollection collection with the specified initial capacity.

こちらもご覧ください

SiteMapNodeCollection(SiteMapNode)

SiteMapNodeCollection クラスの新しいインスタンスを初期化して、SiteMapNode オブジェクトをコレクションの InnerList プロパティに追加します。Initializes a new instance of the SiteMapNodeCollection class and adds the SiteMapNode object to the InnerList property for the collection.

public:
 SiteMapNodeCollection(System::Web::SiteMapNode ^ value);
public SiteMapNodeCollection (System.Web.SiteMapNode value);
new System.Web.SiteMapNodeCollection : System.Web.SiteMapNode -> System.Web.SiteMapNodeCollection
Public Sub New (value As SiteMapNode)

パラメーター

例外

valuenull です。value is null.

次のコード例は、単一の初期 SiteMapNode オブジェクトを使用して SiteMapNodeCollection コレクションを作成し、AddRange メソッドを使用して SiteMapNode オブジェクトの SiteMapNodeCollection を追加する方法を示しています。The following code example demonstrates how to create a SiteMapNodeCollection collection with a single initial SiteMapNode object, and then add a SiteMapNodeCollection of SiteMapNode objects to it using the AddRange method. 個々の SiteMapNode オブジェクトが読み取り専用である場合でも、SiteMapNodeCollectionを変更できます。You can modify the SiteMapNodeCollection, even though the individual SiteMapNode objects might be read-only.


// 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>");
}

' 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

注釈

SiteMapNodeCollection コンストラクターを使用して、1つの初期 SiteMapNode オブジェクトで SiteMapNodeCollection コレクションを作成します。Use the SiteMapNodeCollection constructor to create a SiteMapNodeCollection collection with a single initial SiteMapNode object. AddAddRange、または Insert メソッドを使用して、SiteMapNodeCollection に要素を追加できます。You can add elements to the SiteMapNodeCollection using the Add, AddRange, or Insert method.

こちらもご覧ください

SiteMapNodeCollection(SiteMapNode[])

SiteMapNodeCollection クラスの新しいインスタンスを初期化して、SiteMapNode 型の配列をコレクションの InnerList プロパティに追加します。Initializes a new instance of the SiteMapNodeCollection class and adds the array of type SiteMapNode to the InnerList property for the collection.

public:
 SiteMapNodeCollection(cli::array <System::Web::SiteMapNode ^> ^ value);
public SiteMapNodeCollection (System.Web.SiteMapNode[] value);
new System.Web.SiteMapNodeCollection : System.Web.SiteMapNode[] -> System.Web.SiteMapNodeCollection
Public Sub New (value As SiteMapNode())

パラメーター

value
SiteMapNode[]

SiteMapNode に追加する SiteMapNodeCollection 型の配列。An array of type SiteMapNode to add to the SiteMapNodeCollection.

例外

valuenull です。value is null.

注釈

SiteMapNodeCollection コンストラクターを使用することは、SiteMapNodeCollection コンストラクターを呼び出し、AddRange メソッドを使用して SiteMapNodeCollection コレクションに要素を追加することと同じです。Using the SiteMapNodeCollection constructor is equivalent to calling the SiteMapNodeCollection constructor and adding elements to the SiteMapNodeCollection collection with the AddRange method.

こちらもご覧ください

SiteMapNodeCollection(SiteMapNodeCollection)

SiteMapNodeCollection クラスの新しいインスタンスを初期化して、指定した SiteMapNodeCollection コレクションのリスト項目をすべてコレクションの InnerList プロパティに追加します。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.

public:
 SiteMapNodeCollection(System::Web::SiteMapNodeCollection ^ value);
public SiteMapNodeCollection (System.Web.SiteMapNodeCollection value);
new System.Web.SiteMapNodeCollection : System.Web.SiteMapNodeCollection -> System.Web.SiteMapNodeCollection
Public Sub New (value As SiteMapNodeCollection)

パラメーター

value
SiteMapNodeCollection

現在の SiteMapNodeCollection に追加する SiteMapNode を格納している SiteMapNodeCollectionA SiteMapNodeCollection that contains the SiteMapNode to add to the current SiteMapNodeCollection.

例外

valuenull です。value is null.

次のコード例は、ベースとして SiteMapNode オブジェクトの別の SiteMapNodeCollection を使用して SiteMapNodeCollection コレクションを作成する方法を示しています。The following code example demonstrates how to create a SiteMapNodeCollection collection using another SiteMapNodeCollection of SiteMapNode objects as a base. SiteMapNode.GetAllNodes メソッドは読み取り専用の SiteMapNodeCollectionを返します。これは、IsReadOnly プロパティが trueを返したときに検出されます。The SiteMapNode.GetAllNodes method returns a read-only SiteMapNodeCollection, which is detected when the IsReadOnly property returns true. 読み取り専用 SiteMapNodeCollection を使用して新しい SiteMapNodeCollection が作成され、Add および Remove メソッドを正常に呼び出すことができます。A new SiteMapNodeCollection is created using the read-only SiteMapNodeCollection and the Add and Remove methods can be called successfully.

SiteMapNodeCollection siteNodes = SiteMap.RootNode.GetAllNodes();

if ( siteNodes.IsReadOnly ||
     siteNodes.IsFixedSize )
{
    Response.Write("Collection is read-only or has fixed size.<BR>");

    // Create a new, modifiable collection from the existing one.
    SiteMapNodeCollection modifiableCollection =
         new SiteMapNodeCollection(siteNodes);

    // The MoveNode example method moves a node from position one to
    // the last position in the collection.
    MoveNode(modifiableCollection);
}
else {
    MoveNode(siteNodes);
}

Dim siteNodes As SiteMapNodeCollection
siteNodes = SiteMap.RootNode.GetAllNodes()

If siteNodes.IsReadOnly Or siteNodes.IsFixedSize Then

    Response.Write("Collection is read-only or has fixed size.<BR>")

    ' Create a new, modifiable collection from the existing one.
    Dim modifiableCollection As SiteMapNodeCollection
    modifiableCollection = New SiteMapNodeCollection(siteNodes)

    ' The MoveNode example method moves a node from position one to
    ' the last position in the collection.
    MoveNode(modifiableCollection)
Else
    MoveNode(siteNodes)
End If

注釈

SiteMapNodeCollection コンストラクターを使用することは、SiteMapNodeCollection コンストラクターを呼び出し、AddRange メソッドを使用して SiteMapNodeCollection コレクションに要素を追加することと同じです。Using the SiteMapNodeCollection constructor is equivalent to calling the SiteMapNodeCollection constructor and adding elements to the SiteMapNodeCollection collection with the AddRange method.

適用対象