SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) 方法

定义

命名空间:

System.Web

程序集:

System.Web.dll

返回一个只读集合，其中包含指定的 SiteMapNodeCollection 集合中的节点。

public:
 static System::Web::SiteMapNodeCollection ^ ReadOnly(System::Web::SiteMapNodeCollection ^ collection);

public static System.Web.SiteMapNodeCollection ReadOnly (System.Web.SiteMapNodeCollection collection);

static member ReadOnly : System.Web.SiteMapNodeCollection -> System.Web.SiteMapNodeCollection

Public Shared Function ReadOnly (collection As SiteMapNodeCollection) As SiteMapNodeCollection

参数

collection

SiteMapNodeCollection

SiteMapNodeCollection 包含的 SiteMapNode 对象要添加到只读 SiteMapNodeCollection 中。

返回

SiteMapNodeCollection

与原始 SiteMapNodeCollection 具有相同 SiteMapNode 元素和结构的只读 SiteMapNodeCollection。

例外

ArgumentNullException

collection 为 null。

示例

下面的代码示例演示如何使用 IsReadOnly 属性来测试集合是 SiteMapNodeCollection 只读还是可修改的。 如果 siteNodes 可修改， MoveNode 则调用它;否则，会创建一个克隆 SiteMapNodeCollection ，用作 siteNodes 基。

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

注解

可以通过检查IsReadOnly属性来测试集合是否SiteMapNodeCollection为只读。 当属性为只读时，该IsFixedSize属性也会返回true。SiteMapNodeCollection

继承者说明

只读SiteMapNodeCollection集合支持读取和搜索操作，但不支持Add(SiteMapNode)默认AddRange索引器属性Item[Int32]上的 setter、、Insert(Int32, SiteMapNode)Clear()Remove(SiteMapNode)RemoveAt(Int32)和方法。