Hashtable.ContainsKey(Object) Método

Definición

Espacio de nombres:

System.Collections

Ensamblado:

System.Runtime.dll

Source:

Hashtable.cs

Determina si Hashtable contiene una clave específica.

C#

public virtual bool ContainsKey (object key);

Parámetros

key

Object

Clave que se buscará en Hashtable.

Devoluciones

Boolean

true si la colección Hashtable contiene un elemento con la clave especificada; en caso contrario, false.

Excepciones

ArgumentNullException

key es null.

Ejemplos

En el ejemplo siguiente se muestra cómo determinar si Hashtable contiene un elemento específico.

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.

*/

Comentarios

Este método se comporta exactamente como Contains.

Este método es una O(1) operación.

A partir de .NET Framework 2.0, este método usa los objetos Equals y CompareTo métodos de la colección en item para determinar si el elemento existe. En las versiones anteriores de .NET Framework, esta determinación se realizó mediante el uso de los Equals métodos y CompareTo del item parámetro en los objetos de la colección.

Se aplica a

Consulte también

• Contains(Object)
• ContainsValue(Object)