共用方式為

SiteMapNodeCollection.AddRange 方法

  • 參考

定義

命名空間:
System.Web
組件:
System.Web.dll

將一組 SiteMapNode 物件加入至集合。

多載

AddRange(SiteMapNode[])

將類型為 SiteMapNode 的陣列加入至集合。
AddRange(SiteMapNodeCollection)

將指定 SiteMapNodeCollection 中的節點加入至目前的集合。

AddRange(SiteMapNode[])

將類型為 SiteMapNode 的陣列加入至集合。

public:
 virtual void AddRange(cli::array <System::Web::SiteMapNode ^> ^ value);
public virtual void AddRange (System.Web.SiteMapNode[] value);
abstract member AddRange : System.Web.SiteMapNode[] -> unit
override this.AddRange : System.Web.SiteMapNode[] -> unit
Public Overridable Sub AddRange (value As SiteMapNode())

參數

value
SiteMapNode[]

要新增至目前 SiteMapNodeCollection之類型 SiteMapNode 陣列。

例外狀況

ArgumentException

value null。

NotSupportedException

SiteMapNodeCollection 是唯讀的。

備註

傳遞至 AddRange 方法的數位可以包含 null 值;不過，當操作 SiteMapNodeCollection 集合時，這會導致非預期的例外狀況。

您無法將 SiteMapNode 物件新增至唯讀或固定大小 SiteMapNodeCollection。 您可以藉由檢查 IsReadOnly 屬性，測試 SiteMapNodeCollection 是否為唯讀。

另請參閱

適用於

AddRange(SiteMapNodeCollection)

將指定 SiteMapNodeCollection 中的節點加入至目前的集合。

public:
 virtual void AddRange(System::Web::SiteMapNodeCollection ^ value);
public virtual void AddRange (System.Web.SiteMapNodeCollection value);
abstract member AddRange : System.Web.SiteMapNodeCollection -> unit
override this.AddRange : System.Web.SiteMapNodeCollection -> unit
Public Overridable Sub AddRange (value As SiteMapNodeCollection)

參數

value
SiteMapNodeCollection

包含要加入至目前 SiteMapNodeCollection之 SiteMapNode 物件的 SiteMapNodeCollection。

例外狀況

ArgumentException

value null。

NotSupportedException

SiteMapNodeCollection 是唯讀的。

範例

下列程式代碼範例示範如何建立可修改的 SiteMapNodeCollection 集合，然後使用 AddRange 方法將 SiteMapNode 物件加入其中。


// 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

備註

傳遞至 AddRange 方法的 SiteMapNodeCollection 集合可以包含 nullSiteMapNode 物件;不過，當操作 SiteMapNodeCollection 時，這會導致非預期的例外狀況。

您無法將 SiteMapNode 物件新增至唯讀或固定大小 SiteMapNodeCollection。 您可以藉由檢查 IsReadOnly 屬性，測試 SiteMapNodeCollection 是否為唯讀。

另請參閱

適用於