SiteMapNodeCollection 類別

定義

命名空間:

System.Web

組件:

System.Web.dll

提供 SiteMapNode 物件的強類型集合，並實作 IHierarchicalEnumerable 介面以支援整個集合的巡覽。

public ref class SiteMapNodeCollection : System::Collections::IList, System::Web::UI::IHierarchicalEnumerable

public class SiteMapNodeCollection : System.Collections.IList, System.Web.UI.IHierarchicalEnumerable

type SiteMapNodeCollection = class
    interface IHierarchicalEnumerable
    interface IEnumerable
    interface IList
    interface ICollection

Public Class SiteMapNodeCollection
Implements IHierarchicalEnumerable, IList

繼承

Object

SiteMapNodeCollection

實作

ICollection IEnumerable IList IHierarchicalEnumerable

範例

下列程式代碼範例示範如何建立 SiteMapNodeCollection 集合，然後使用 方法將 物件加入 SiteMapNode 其中 AddRange 。 SiteMapNodeCollection是目前網站地圖的子集，只顯示前兩個階層式層級。

// 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 會為 SiteMapNode 物件提供強型別集合。 它會在內部將物件儲存 SiteMapNode 在以零起始的陣列中。

您可以在第一次建立集合時修改 SiteMapNodeCollection 集合，然後使用下列方法來新增、複製和移除 SiteMapNode 物件：

• 若要新增 SiteMapNode 物件，請使用 Add、 AddRange和 Insert 方法。

• 若要複製 SiteMapNode 物件，請使用 CopyTo 方法。

• 若要移除 SiteMapNode 物件，請使用 Remove 方法。

您可以使用靜態ReadOnly方法來建立唯讀SiteMapNodeCollection的 ，不允許新增、複製或移除SiteMapNode物件。 SiteMapNodeCollection與 GetChildren 方法所SiteMapNode.GetAllNodes傳回的集合是唯讀的，如同SiteMapNodeCollection從提供者傳回之 物件上SiteMapNode存取 屬性時ChildNodes所傳回的 。 NotSupportedException如果您嘗試藉由設定預設索引器屬性或使用下列任一方法來修改唯讀SiteMapNodeCollection，則會擲回例外狀況：

• Add

• AddRange

• Clear

• Insert

• Remove

• RemoveAt

IsReadOnly使用 屬性來檢查集合，再呼叫上述清單中的任何方法。

建構函式

SiteMapNodeCollection()	初始化 SiteMapNodeCollection 類別的新執行個體，這個執行個體是預設的。
SiteMapNodeCollection(Int32)	使用指定的初始容量，初始化 SiteMapNodeCollection 類別的新執行個體。
SiteMapNodeCollection(SiteMapNode)	初始化 SiteMapNodeCollection 類別的新執行個體，並將 SiteMapNode 物件加入至集合的 InnerList 屬性。
SiteMapNodeCollection(SiteMapNode[])	初始化 SiteMapNodeCollection 類別的新執行個體，並將 SiteMapNode 型別陣列加入至集合的 InnerList 屬性。
SiteMapNodeCollection(SiteMapNodeCollection)	初始化 SiteMapNodeCollection 類別的新執行個體，並將指定之 SiteMapNodeCollection 集合的所有清單項目加入至集合的 InnerList 屬性。

屬性

Count	取得集合所包含的項目數目。
IsFixedSize	取得布林值，指出節點是否可以加入至集合或從集合減去。
IsReadOnly	取得布林值，指出集合是否為唯讀。
IsSynchronized	取得布林值，指出對集合的存取是否為同步的 (安全執行緒 (Thread-Safe))。
Item[Int32]	取得或設定位於集合中所指定索引處的 SiteMapNode 物件。
SyncRoot	取得物件，這個物件可以用來對集合進行同步存取。

方法

Add(SiteMapNode)	將單 SiteMapNode 一物件加入至 SiteMapNodeCollection 集合。
AddRange(SiteMapNode[])	將 SiteMapNode 型別陣列加入至集合。
AddRange(SiteMapNodeCollection)	將指定 SiteMapNodeCollection 中的節點加入至目前的集合。
Clear()	移除集合的所有項目。
Contains(SiteMapNode)	判斷集合是否含有指定的 SiteMapNode 物件。
CopyTo(SiteMapNode[], Int32)	從目標陣列的指定索引處開始，將整個集合複製到相容的一維陣列。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetDataSourceView(SiteMapDataSource, String)	擷取與目前集合中之節點關聯的 SiteMapDataSourceView 物件。
GetEnumerator()	擷取對列舉值物件的參考，這個物件是用來逐一查看集合。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetHierarchicalDataSourceView()	擷取與目前集合中之節點關聯的 SiteMapHierarchicalDataSourceView 物件。
GetHierarchyData(Object)	傳回指定列舉項目的階層式資料項目。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IndexOf(SiteMapNode)	搜尋指定的 SiteMapNode 物件，然後傳回在整個集合中第一個符合元素之以零起始的索引。
Insert(Int32, SiteMapNode)	將指定的 SiteMapNode 物件插入至集合中所指定索引處。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnValidate(Object)	當驗證數值時，執行額外的自訂處理序。
ReadOnly(SiteMapNodeCollection)	傳回唯讀集合，其中包含指定之 SiteMapNodeCollection 集合中的節點。
Remove(SiteMapNode)	從集合中移除指定的 SiteMapNode 物件。
RemoveAt(Int32)	SiteMapNode拿掉集合指定索引處的物件SiteMapNodeCollection。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

ICollection.CopyTo(Array, Int32)	從特定的陣列索引處開始，將 ICollection 介面的項目複製到陣列。 此類別無法獲得繼承。
ICollection.Count	取得 ICollection 介面中所包含的項目數。 此類別無法獲得繼承。
ICollection.IsSynchronized	取得 Boolean 值，指出對 ICollection 介面的存取是否為同步 (安全執行緒)。 此類別無法獲得繼承。
ICollection.SyncRoot	取得物件，可用來對 ICollection 介面進行同步存取。 此類別無法獲得繼承。
IEnumerable.GetEnumerator()	傳回逐一查看集合的列舉值。 如需這個成員的說明，請參閱 GetEnumerator()。
IHierarchicalEnumerable.GetHierarchyData(Object)	傳回指定列舉項目的階層式資料項目。 如需這個成員的說明，請參閱 GetHierarchyData(Object)。
IList.Add(Object)	將項目加入至 IList 介面中的集合。 如需這個成員的說明，請參閱 Add(Object)。
IList.Clear()	將所有項目從 IList 介面中的集合移除。 如需這個成員的說明，請參閱 Clear()。
IList.Contains(Object)	判斷 IList 介面中的集合是否包含指定的布林值。
IList.IndexOf(Object)	判斷 IList 介面所傳回之集合中特定項目的索引。 如需這個成員的說明，請參閱 IndexOf(Object)。
IList.Insert(Int32, Object)	將項目插入至 IList 介面的集合中指定之索引處。 如需這個成員的說明，請參閱 Insert(Int32, Object)。
IList.IsFixedSize	取得 Boolean 值，指出集合是否具有固定大小。 如需這個成員的說明，請參閱 IsFixedSize。
IList.IsReadOnly	取得 Boolean 值，指出集合是否為唯讀。 如需這個成員的說明，請參閱 IsReadOnly。
IList.Item[Int32]	取得指定索引處的 IList 項目。
IList.Remove(Object)	從 IList 介面的集合中移除特定物件的第一個符合項目。 如需這個成員的說明，請參閱 Remove(Object)。
IList.RemoveAt(Int32)	移除在指定索引處的 IList 項目。 如需這個成員的說明，請參閱 RemoveAt(Int32)。

擴充方法

Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別來篩選 IEnumerable 的項目。
AsParallel(IEnumerable)	啟用查詢的平行化作業。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。

另請參閱

• SiteMap
• SiteMapNode
• SiteMapProvider
• IHierarchyData
• ASP.NET 網站導覽概觀
• ASP.NET 網站地圖