Hashtable.ContainsValue(Object) 方法

定義

命名空間:

System.Collections

組件:

System.Runtime.dll

來源:

Hashtable.cs

判斷 Hashtable 是否包含特定值。

C#

public virtual bool ContainsValue (object? value);

參數

value

Object

要在 Hashtable 中尋找的值。 這個值可以是 null。

傳回

Boolean

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

範例

下列範例示範如何判斷 是否 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.

*/

備註

的專案值 Hashtable 會與使用 Object.Equals 方法的指定值進行比較。

此方法會執行線性搜尋;因此，這個方法是 O(n) 作業，其中 n 是 Count。

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

適用於

另請參閱

• ContainsKey(Object)
• Equals(Object)