OrderedDictionary.Clear Metoda

Definicja

Usuwa wszystkie elementy z OrderedDictionary kolekcji.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 ()

Implementuje

Wyjątki

OrderedDictionaryKolekcja jest tylko do odczytu.The OrderedDictionary collection is read-only.

Przykłady

Poniższy przykład kodu demonstruje modyfikację OrderedDictionary kolekcji.The following code example demonstrates the modification of an OrderedDictionary collection. W tym przykładzie Clear Metoda jest używana do opróżniania OrderedDictionary , a następnie OrderedDictionary jest ponownie wypełniana.In this example, the Clear method is used to empty the OrderedDictionary, and then the OrderedDictionary is repopulated. Ten kod jest częścią większego przykładu kodu, który może być wyświetlany w 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)

Uwagi

Po wywołaniu Clear metody Count Właściwość jest ustawiona na zero, a odwołania do innych obiektów z elementów kolekcji również są wydane.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. Pojemność nie jest zmieniana w wyniku wywołania tej metody.The capacity is not changed as a result of calling this method.

Dotyczy