OrderedDictionary.IsReadOnly Eigenschaft

Definition

Namespace:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Quelle:

OrderedDictionary.cs

Ruft einen Wert ab, der angibt, ob die OrderedDictionary-Auflistung schreibgeschützt ist.

public:
 property bool IsReadOnly { bool get(); };

public bool IsReadOnly { get; }

member this.IsReadOnly : bool

Public ReadOnly Property IsReadOnly As Boolean

Eigenschaftswert

Boolean

true, wenn die OrderedDictionary-Auflistung schreibgeschützt ist, andernfalls false. Der Standardwert ist false.

Implementiert

IsReadOnly

Beispiele

Im folgenden Codebeispiel wird die Änderung einer OrderedDictionary Auflistung veranschaulicht. In diesem Beispiel wird die IsReadOnly -Eigenschaft verwendet, um zu bestimmen, ob der OrderedDictionary geändert werden kann. Dieser Code ist Teil eines größeren Codebeispiels, das unter OrderedDictionaryangezeigt werden kann.

// Modifying the OrderedDictionary
if (!myOrderedDictionary->IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary->Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary->RemoveAt(myOrderedDictionary->Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary->Contains("keyToDelete"))
    {
        myOrderedDictionary->Remove("keyToDelete");
    }
}

// Modifying the OrderedDictionary
if (!myOrderedDictionary.IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary.Contains("keyToDelete"))
    {
        myOrderedDictionary.Remove("keyToDelete");
    }
}

' Modifying the OrderedDictionary
If Not myOrderedDictionary.IsReadOnly Then

    ' Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1")

    ' Modify the value of the entry with the key "testKey2"
    myOrderedDictionary("testKey2") = "modifiedValue"

    ' Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1)

    ' Remove the "keyToDelete" entry, if it exists
    If (myOrderedDictionary.Contains("keyToDelete")) Then
        myOrderedDictionary.Remove("keyToDelete")
    End If
End If

Hinweise

Eine schreibgeschützte Auflistung gestattet nach dem Erstellen der Auflistung weder das Hinzufügen noch das Ändern oder Entfernen von Elementen.

Eine sammlung, die schreibgeschützt ist, ist einfach eine Auflistung mit einem Wrapper, der änderungen der Auflistung verhindert. Wenn Änderungen an der zugrunde liegenden Auflistung vorgenommen werden, spiegelt die schreibgeschützte Auflistung diese Änderungen wider.