Hashtable.ContainsValue 方法

确定 Hashtable 是否包含特定值。

**命名空间:**System.Collections
**程序集:**mscorlib（在 mscorlib.dll 中）

语法

声明
Public Overridable Function ContainsValue ( _
    value As Object _
) As Boolean
用法
Dim instance As Hashtable
Dim value As Object
Dim returnValue As Boolean

returnValue = instance.ContainsValue(value)

public virtual bool ContainsValue (
    Object value
)

public:
virtual bool ContainsValue (
    Object^ value
)

public boolean ContainsValue (
    Object value
)

public function ContainsValue (
    value : Object
) : boolean

参数

• value
  要在 Hashtable 中定位的值。该值可以为 空引用（在 Visual Basic 中为 Nothing）。

返回值

如果 Hashtable 包含带有指定的 value 的元素，则为 true；否则为 false。

备注

使用 Object.Equals 方法将 Hashtable 的元素的值与指定的值相比较。

此方法执行线性搜索；因此，此方法的运算复杂度为 O(n)，其中 n 是 Count。

示例

下面的示例说明如何确定 Hashtable 是否包含特定的元素。

Imports System
Imports System.Collections

Public Class SamplesHashtable

    Public Shared Sub Main()

        ' Creates and initializes a new Hashtable.
        Dim myHT As 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.
        Dim myKey As Integer = 2
        Console.Write("The key ""{0}"" is ", myKey)
        If(myHT.ContainsKey(myKey))
           Console.WriteLine("in the Hashtable.")
        Else
           Console.WriteLine("NOT in the Hashtable.")
        End If

        myKey = 6
        Console.Write("The key ""{0}"" is ", myKey)
        If(myHT.ContainsKey(myKey))
           Console.WriteLine(" in the Hashtable.")
        Else
           Console.WriteLine(" NOT in the Hashtable.")
        End If

        ' Searches for a specific value.
        Dim myValue As String = "three"
        Console.Write("The value ""{0}"" is ", myValue)
        If(myHT.ContainsValue(myValue))
           Console.WriteLine(" in the Hashtable.")
        Else
           Console.WriteLine(" NOT in the Hashtable.")
        End If

        myValue = "nine"
        Console.Write("The value ""{0}"" is ", myValue)
        If(myHT.ContainsValue(myValue))
           Console.WriteLine(" in the Hashtable.")
        Else
           Console.WriteLine(" NOT in the Hashtable.")
        End If

    End Sub 'Main

    Public Shared Sub PrintIndexAndKeysAndValues(myHT As Hashtable)
        Dim i As Integer = 0
        Console.WriteLine(vbTab + "-INDEX-" + vbTab + "-KEY-" + vbTab + "-VALUE-")
        Dim de As DictionaryEntry
        For Each de In  myHT
            Console.WriteLine(vbTab + "[{0}]:" + vbTab + "{1}" + vbTab + "{2}", i, de.Key, de.Value)
            i = i + 1
        Next de
        Console.WriteLine()
    End Sub 'PrintIndexAndKeysAndValues

End Class 'SamplesHashtable 


' 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.

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

   public static void Main()  {

      // Creates and initializes a new Hashtable.
      Hashtable 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.
      String 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[{0}]:\t{1}\t{2}", i++, de.Key, 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.

*/ 

using namespace System;
using namespace System::Collections;
void PrintIndexAndKeysAndValues( Hashtable^ myHT );
int main()
{
   
   // Creates and initializes a new Hashtable.
   Hashtable^ myHT = gcnew Hashtable;
   myHT->Add( (int^)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 ) ? (String^)"in the Hashtable" : "NOT in the Hashtable" );
   myKey = 6;
   Console::WriteLine( "The key \"{0}\" is {1}.", myKey, myHT->ContainsKey( myKey ) ? (String^)"in the Hashtable" : "NOT in the Hashtable" );
   
   // Searches for a specific value.
   String^ myValue = "three";
   Console::WriteLine( "The value \"{0}\" is {1}.", myValue, myHT->ContainsValue( myValue ) ? (String^)"in the Hashtable" : "NOT in the Hashtable" );
   myValue = "nine";
   Console::WriteLine( "The value \"{0}\" is {1}.", myValue, myHT->ContainsValue( myValue ) ? (String^)"in the Hashtable" : "NOT in the Hashtable" );
}

void PrintIndexAndKeysAndValues( Hashtable^ myHT )
{
   int i = 0;
   Console::WriteLine( "\t-INDEX-\t-KEY-\t-VALUE-" );
   IEnumerator^ myEnum = myHT->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DictionaryEntry de =  *safe_cast<DictionaryEntry ^>(myEnum->Current);
      Console::WriteLine( "\t[{0}]:\t{1}\t{2}", i++, de.Key, 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.

 */

import System.*;
import System.Collections.*;

public class SamplesHashtable
{
    public static void main(String[] args)
    {
        // Creates and initializes a new Hashtable.
        Hashtable myHT = new Hashtable();

        myHT.Add(new Integer(0), "zero");
        myHT.Add(new Integer(1), "one");
        myHT.Add(new Integer(2), "two");
        myHT.Add(new Integer(3), "three");
        myHT.Add(new Integer(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}.", 
            System.Convert.ToString(myKey), 
            (myHT.ContainsKey(new Integer(myKey))) ? 
            "in the Hashtable" : "NOT in the Hashtable");
        myKey = 6;
        Console.WriteLine("The key \"{0}\" is {1}.", 
            System.Convert.ToString(myKey), 
            (myHT.ContainsKey(new Integer(myKey))) ? 
            "in the Hashtable" : "NOT in the Hashtable");

        // Searches for a specific value.
        String 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");
    } //main

    public static void PrintIndexAndKeysAndValues(Hashtable myHT)
    {
        int i = 0;
        Console.WriteLine("\t-INDEX-\t-KEY-\t-VALUE-");
        IEnumerator myEnumerator = myHT.GetEnumerator();

        while (myEnumerator.MoveNext()) {
            DictionaryEntry de = (DictionaryEntry)myEnumerator.get_Current();
            Console.WriteLine("\t[{0}]:\t{1}\t{2}", 
                System.Convert.ToString(i++), 
                de.get_Key().toString(), de.get_Value().toString());
        }
        Console.WriteLine();
    } //PrintIndexAndKeysAndValues
} //SamplesHashtable 

/* 
 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.
 */

import System
import System.Collections
import Microsoft.VisualBasic

// Creates and initializes a new Hashtable.
var myHT : Hashtable = 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.
var msg : String
var myKey : int = 2
if(myHT.ContainsKey(myKey))
    msg = "in the Hashtable"
else
    msg = "NOT in the Hashtable"
Console.WriteLine("The key \"{0}\" is {1}.", myKey, msg)
myKey = 6
if(myHT.ContainsKey(myKey))
    msg = "in the Hashtable"
else
    msg = "NOT in the Hashtable"
Console.WriteLine("The key \"{0}\" is {1}.", myKey, msg)

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

function PrintIndexAndKeysAndValues(myList : Hashtable){
    var myEnumerator : IDictionaryEnumerator = myList.GetEnumerator()
    var i : int = 0
    Console.WriteLine("\t-INDEX-\t-KEY-\t-VALUE-")
    while(myEnumerator.MoveNext()){
        Console.WriteLine("\t[{0}]:\t{1}\t{2}", i++, myEnumerator.Key,
            myEnumerator.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. 

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

Hashtable 类
Hashtable 成员
System.Collections 命名空间
ContainsKey
Object.Equals