OrderedDictionary.Clear Methode

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

Die OrderedDictionary-Auflistung ist schreibgeschützt.The OrderedDictionary collection is read-only.

Beispiele

Im folgenden Codebeispiel wird die Änderung einer-Auflistung veranschaulicht OrderedDictionary .The following code example demonstrates the modification of an OrderedDictionary collection. In diesem Beispiel wird die Clear -Methode verwendet, um zu leeren OrderedDictionary , 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 angezeigt werden kann OrderedDictionary .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 der- Clear 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: