OrderedDictionary.Clear Methode

Referenz

Definition

Namespace:: System.Collections.Specialized

Assemblys:: System.dll, System.Collections.Specialized.dll

Assembly:: System.Collections.Specialized.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: OrderedDictionary.cs

Quelle:: OrderedDictionary.cs

Quelle:: OrderedDictionary.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 verwendet, um die OrderedDictionaryzu leeren, und dann wird die OrderedDictionary wieder aufgefüllt. Dieser Code ist Teil eines größeren Codebeispiels, das unter OrderedDictionaryangezeigt werden 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 durch das Aufrufen dieser Methode nicht geändert.

Gilt für: