OrderedDictionary.Clear Methode

Definition

Namespace:

System.Collections.Specialized

Assemblys:

System.dll, System.Collections.Specialized.dll

Assembly:

System.Collections.Specialized.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Entfernt alle Elemente aus der OrderedDictionary-Auflistung.

public:
 virtual void Clear();

public void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Sub Clear ()

Implementiert

Clear()

Ausnahmen

NotSupportedException

Die OrderedDictionary-Auflistung ist schreibgeschützt.

Beispiele

Im folgenden Codebeispiel wird die Änderung einer OrderedDictionary Auflistung veranschaulicht. In diesem Beispiel wird die Clear Methode zum Leeren des OrderedDictionary, und dann OrderedDictionary erneut aufgefüllt. Dieser Code ist Teil eines größeren Codebeispiels, das angezeigt OrderedDictionarywerden kann.

// Clear the OrderedDictionary and add new values
myOrderedDictionary->Clear();
myOrderedDictionary->Add("newKey1", "newValue1");
myOrderedDictionary->Add("newKey2", "newValue2");
myOrderedDictionary->Add("newKey3", "newValue3");

// Display the contents of the "new" Dictionary using an enumerator
IDictionaryEnumerator^ myEnumerator =
    myOrderedDictionary->GetEnumerator();

Console::WriteLine(
    "{0}Displaying the entries of a \"new\" OrderedDictionary.",
    Environment::NewLine);

DisplayEnumerator(myEnumerator);

// Clear the OrderedDictionary and add new values
myOrderedDictionary.Clear();
myOrderedDictionary.Add("newKey1", "newValue1");
myOrderedDictionary.Add("newKey2", "newValue2");
myOrderedDictionary.Add("newKey3", "newValue3");

// Display the contents of the "new" Dictionary using an enumerator
IDictionaryEnumerator myEnumerator =
    myOrderedDictionary.GetEnumerator();

Console.WriteLine(
    "{0}Displaying the entries of a \"new\" OrderedDictionary.",
    Environment.NewLine);

DisplayEnumerator(myEnumerator);

' Clear the OrderedDictionary and add new values
myOrderedDictionary.Clear()
myOrderedDictionary.Add("newKey1", "newValue1")
myOrderedDictionary.Add("newKey2", "newValue2")
myOrderedDictionary.Add("newKey3", "newValue3")

' Display the contents of the "new" Dictionary Imports an enumerator
Dim myEnumerator As IDictionaryEnumerator = _
    myOrderedDictionary.GetEnumerator()

Console.WriteLine( _
    "{0}Displaying the entries of a 'new' OrderedDictionary.", _
    Environment.NewLine)

DisplayEnumerator(myEnumerator)

Hinweise

Nach dem Aufrufen der Clear Methode wird die Count Eigenschaft auf Null festgelegt und Verweise auf andere Objekte aus Elementen der Auflistung werden ebenfalls freigegeben. Die Kapazität wird aufgrund des Aufrufens dieser Methode nicht geändert.