OrderedDictionary.Clear Método

Definición

Espacio de nombres:

System.Collections.Specialized

Ensamblado:

System.Collections.Specialized.dll

Source:

OrderedDictionary.cs

Quita todos los elementos de la colección OrderedDictionary.

public:
 virtual void Clear();

public void Clear ();

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

Public Sub Clear ()

Implementaciones

Clear()

Excepciones

NotSupportedException

La colección OrderedDictionary es de sólo lectura.

Ejemplos

En el ejemplo de código siguiente se muestra la modificación de una OrderedDictionary colección. En este ejemplo, el Clear método se usa para vaciar OrderedDictionaryy, a continuación OrderedDictionary , se vuelve a rellenar. Este código forma parte de un ejemplo de código más grande que se puede ver en 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)

Comentarios

Después de llamar al Clear método , la Count propiedad se establece en cero y también se liberan las referencias a otros objetos de los elementos de la colección. La capacidad no se cambia como resultado de llamar a este método.