SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Метод

Определение

Возвращает коллекцию, заданную по умолчанию, содержащую узлы в указанной коллекцииSiteMapNodeCollection.Returns a read-only collection that contains the nodes in the specified SiteMapNodeCollection collection.

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, заданную по умолчанию.The SiteMapNodeCollection that contains the SiteMapNode objects to add to the read-only SiteMapNodeCollection.

Возвраты

Коллекция SiteMapNodeCollection, заданная по умолчанию, с одинаковыми элементами SiteMapNode и структурой как у первоначальной коллекции SiteMapNodeCollection.A read-only SiteMapNodeCollection with the same SiteMapNode elements and structure as the original SiteMapNodeCollection.

Исключения

collectionnull.collection is null.

Примеры

В следующем примере кода показано, как использовать IsReadOnly свойство, чтобы проверить, является SiteMapNodeCollection ли коллекция доступной только для чтения или изменяемой.The following code example demonstrates how to use the IsReadOnly property to test whether a SiteMapNodeCollection collection is read-only or modifiable. Если siteNodes является изменяемым MoveNode , вызывается для него; в противном SiteMapNodeCollection случае создается клон с siteNodes использованием в качестве базового.If siteNodes is modifiable, MoveNode is called on it; otherwise, a clone SiteMapNodeCollection is created, using siteNodes as a base.

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 проверки свойства.You can test whether a SiteMapNodeCollection collection is read-only by checking the IsReadOnly property. Свойство также возвращает true значение, если SiteMapNodeCollection объект доступен только для чтения. IsFixedSizeThe IsFixedSize property also returns true when a SiteMapNodeCollection is read-only.

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

Коллекция, доступная SiteMapNodeCollection только для чтения, поддерживает операции чтения и поиска, но не Add(SiteMapNode)поддерживает AddRangeметоды Clear(), Insert(Int32, SiteMapNode), Remove(SiteMapNode),, RemoveAt(Int32) и метод задания для индексатора по умолчанию. свойство, Item[Int32].A read-only SiteMapNodeCollection collection supports read and search operations, but does not support the Add(SiteMapNode), AddRange, Clear(), Insert(Int32, SiteMapNode), Remove(SiteMapNode), and RemoveAt(Int32) methods, nor the setter on the default indexer property, Item[Int32].

Применяется к