OrderedDictionary.Clear OrderedDictionary.Clear OrderedDictionary.Clear OrderedDictionary.Clear Method

Definition

Entfernt alle Elemente aus der OrderedDictionary-Auflistung.Removes all elements from the OrderedDictionary collection.

public:
 virtual void Clear();
public void Clear ();
abstract member Clear : unit -> unit
override this.Clear : unit -> unit
Public Sub Clear ()

Implementiert

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird die Änderung einer OrderedDictionary -Auflistung veranschaulicht.The following code example demonstrates the modification of an OrderedDictionary collection. In diesem Beispiel Clear wird die-Methode verwendet, um zu OrderedDictionaryleeren, und dann OrderedDictionary wird der erneut aufgefüllt.In this example, the Clear method is used to empty the OrderedDictionary, and then the OrderedDictionary is repopulated. Dieser Code ist Teil eines größeren Code Beispiels, das unter OrderedDictionaryangezeigt werden kann.This code is part of a larger code example that can be viewed at OrderedDictionary.

// 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 Clear der-Methode Count wird die-Eigenschaft auf 0 (null) festgelegt, und Verweise auf andere Objekte aus Elementen der Auflistung werden ebenfalls freigegeben.After calling the Clear method, the Count property is set to zero and references to other objects from elements of the collection are also released. Die Kapazität wird nicht geändert, weil diese Methode aufgerufen wird.The capacity is not changed as a result of calling this method.

Gilt für: