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

Комментарии

Вы можете проверить, доступна ли SiteMapNodeCollection коллекция только для чтения, проверив IsReadOnly свойство. Свойство IsFixedSize также возвращается true , если SiteMapNodeCollection свойство доступно только для чтения.

Примечания для тех, кто наследует этот метод

Коллекция, доступная только для SiteMapNodeCollection чтения, поддерживает операции чтения и поиска, но не поддерживает Add(SiteMapNode)методы , AddRange, Clear()Remove(SiteMapNode)Insert(Int32, SiteMapNode)и RemoveAt(Int32) методы задания для свойства Item[Int32]индексатора по умолчанию.