語言

Hashtable.Clear 方法

定義

命名空間:
System.Collections
組件:
mscorlib.dll, System.Collections.NonGeneric.dll
組件:
netstandard.dll, System.Runtime.dll
組件:
System.Collections.NonGeneric.dll
組件:
System.Runtime.Extensions.dll
組件:
mscorlib.dll
組件:
netstandard.dll
來源:
Hashtable.cs
來源:
Hashtable.cs
來源:
Hashtable.cs
來源:
Hashtable.cs
來源:
Hashtable.cs

從 Hashtable移除所有專案。

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

實作

Clear()

例外狀況

NotSupportedException

這是 Hashtable 唯讀的。

範例

以下範例說明如何清除 的 Hashtable值。

using System;
using System.Collections;
public class SamplesHashtable
{

   public static void Main()
   {
      // Creates and initializes a new Hashtable.
      var myHT = new Hashtable();
      myHT.Add("one", "The");
      myHT.Add("two", "quick");
      myHT.Add("three", "brown");
      myHT.Add("four", "fox");
      myHT.Add("five", "jumps");

      // Displays the count and values of the Hashtable.
      Console.WriteLine("Initially,");
      Console.WriteLine($"   Count    : {myHT.Count}");
      Console.WriteLine("   Values:");
      PrintKeysAndValues(myHT);

      // Clears the Hashtable.
      myHT.Clear();

      // Displays the count and values of the Hashtable.
      Console.WriteLine("After Clear,");
      Console.WriteLine("   Count    : {myHT.Count}");
      Console.WriteLine("   Values:" );
      PrintKeysAndValues(myHT);
   }

   public static void PrintKeysAndValues( Hashtable myHT )
   {
      Console.WriteLine("\t-KEY-\t-VALUE-");
      foreach (DictionaryEntry de in myHT)
         Console.WriteLine("\t{de.Key}:\t{de.Value}");
      Console.WriteLine();
   }
}


/*
This code produces the following output.

Initially,
   Count    : 5
   Values:
        -KEY-   -VALUE-
        two:    quick
        three:  brown
        four:   fox
        five:   jumps
        one:    The

After Clear,
   Count    : 0
   Values:
        -KEY-   -VALUE-

*/

Imports System.Collections

Public Class SamplesHashtable

    Public Shared Sub Main()

        ' Creates and initializes a new Hashtable.
        Dim myHT As New Hashtable()
        myHT.Add("one", "The")
        myHT.Add("two", "quick")
        myHT.Add("three", "brown")
        myHT.Add("four", "fox")
        myHT.Add("five", "jumps")

        ' Displays the count and values of the Hashtable.
        Console.WriteLine("Initially,")
        Console.WriteLine($"   Count    : {myHT.Count}")
        Console.WriteLine("   Values:")
        PrintKeysAndValues(myHT)

        ' Clears the Hashtable.
        myHT.Clear()

        ' Displays the count and values of the Hashtable.
        Console.WriteLine("After Clear,")
        Console.WriteLine($"   Count    : {myHT.Count}")
        Console.WriteLine("   Values:")
        PrintKeysAndValues(myHT)

    End Sub


    Public Shared Sub PrintKeysAndValues(myHT As Hashtable)
        Console.WriteLine(vbTab + "-KEY-" + vbTab + "-VALUE-")
        For Each de As DictionaryEntry In myHT
            Console.WriteLine(vbTab + "{0}:" + vbTab + "{1}", de.Key, de.Value)
        Next
        Console.WriteLine()
    End Sub

End Class


' This code produces the following output.
' 
' Initially,
'    Count    : 5
'    Values:
'         -KEY-   -VALUE-
'         two:    quick
'         five:   jumps
'         one:    The
'         three:  brown
'         four:   fox
'
' After Clear,
'    Count    : 0
'    Values:
'         -KEY-   -VALUE-
'

備註

Count 設為零，且集合中元素中對其他物件的引用也會被釋放。 容量保持不變。

此方法是一個 O(n) 運算，其中 n 為 Count。

適用於

另請參閱