Hashtable.Contains(Object) 方法

定義

命名空間:

System.Collections

組件:

System.Runtime.dll

來源:

Hashtable.cs

判斷 Hashtable 是否包含特定索引鍵。

C#

public virtual bool Contains (object key);

參數

key

Object

要在 Hashtable 中尋找的索引鍵。

傳回

Boolean

如果 true 包含具有指定索引鍵的項目，則為 Hashtable，否則為 false。

實作

Contains(Object)

例外狀況

ArgumentNullException

key 為 null。

範例

下列範例示範如何判斷 是否 Hashtable 包含特定元素。

C#

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

   public static void Main()
   {
      // Creates and initializes a new Hashtable.
      var myHT = new Hashtable();
      myHT.Add(0, "zero");
      myHT.Add(1, "one");
      myHT.Add(2, "two");
      myHT.Add(3, "three");
      myHT.Add(4, "four");

      // Displays the values of the Hashtable.
      Console.WriteLine("The Hashtable contains the following values:");
      PrintIndexAndKeysAndValues(myHT);

      // Searches for a specific key.
      int myKey = 2;
      Console.WriteLine("The key \"{0}\" is {1}.", myKey, myHT.ContainsKey(myKey) ? "in the Hashtable" : "NOT in the Hashtable");
      myKey = 6;
      Console.WriteLine("The key \"{0}\" is {1}.", myKey, myHT.ContainsKey(myKey) ? "in the Hashtable" : "NOT in the Hashtable");

      // Searches for a specific value.
      var myValue = "three";
      Console.WriteLine("The value \"{0}\" is {1}.", myValue, myHT.ContainsValue( myValue ) ? "in the Hashtable" : "NOT in the Hashtable");
      myValue = "nine";
      Console.WriteLine("The value \"{0}\" is {1}.", myValue, myHT.ContainsValue( myValue ) ? "in the Hashtable" : "NOT in the Hashtable");
   }

   public static void PrintIndexAndKeysAndValues(Hashtable myHT)
   {
      int i = 0;
      Console.WriteLine("\t-INDEX-\t-KEY-\t-VALUE-");
      foreach (DictionaryEntry de in myHT)
         Console.WriteLine($"\t[{i++}]:\t{de.Key}\t{de.Value}");
      Console.WriteLine();
   }
}


/*
This code produces the following output.

The Hashtable contains the following values:
        -INDEX- -KEY-   -VALUE-
        [0]:    4       four
        [1]:    3       three
        [2]:    2       two
        [3]:    1       one
        [4]:    0       zero

The key "2" is in the Hashtable.
The key "6" is NOT in the Hashtable.
The value "three" is in the Hashtable.
The value "nine" is NOT in the Hashtable.

*/

備註

Contains 會實作 IDictionary.Contains。 其行為與 完全相同 ContainsKey。

這個方法是 O(1) 作業。

從 .NET Framework 2.0 開始，這個方法會使用 集合的物件 Equals 和 CompareTo 方法item來判斷專案是否存在。 在舊版的 .NET Framework 中，這個判斷方式是在Equals集合中的 物件上使用 參數的 item 和 CompareTo 方法進行。

適用於

另請參閱

• ContainsKey(Object)
• IDictionary