Auf Englisch lesen

Freigeben über


StringDictionary.ContainsKey(String) Methode

Definition

Ermittelt, ob das StringDictionary einen bestimmten Schlüssel enthält.

public virtual bool ContainsKey (string key);

Parameter

key
String

Der im StringDictionary zu suchende Schlüssel.

Gibt zurück

true, wenn das StringDictionary einen Eintrag mit dem angegebenen Schlüssel enthält, andernfalls false.

Ausnahmen

Der Schlüssel ist null.

Beispiele

Im folgenden Codebeispiel wird nach einem -Element in einem StringDictionarygesucht.

using System;
using System.Collections;
using System.Collections.Specialized;

public class SamplesStringDictionary  {

   public static void Main()  {

      // Creates and initializes a new StringDictionary.
      StringDictionary myCol = new StringDictionary();
      myCol.Add( "red", "rojo" );
      myCol.Add( "green", "verde" );
      myCol.Add( "blue", "azul" );

      // Displays the values in the StringDictionary.
      Console.WriteLine( "Initial contents of the StringDictionary:" );
      PrintKeysAndValues( myCol );

      // Searches for a key.
      if ( myCol.ContainsKey( "red" ) )
         Console.WriteLine( "The collection contains the key \"red\"." );
      else
         Console.WriteLine( "The collection does not contain the key \"red\"." );
      Console.WriteLine();

      // Searches for a value.
      if ( myCol.ContainsValue( "amarillo" ) )
         Console.WriteLine( "The collection contains the value \"amarillo\"." );
      else
         Console.WriteLine( "The collection does not contain the value \"amarillo\"." );
      Console.WriteLine();
   }

   public static void PrintKeysAndValues( StringDictionary myCol )  {
      Console.WriteLine( "   KEY        VALUE" );
      foreach ( DictionaryEntry de in myCol )
         Console.WriteLine( "   {0,-10} {1}", de.Key, de.Value );
      Console.WriteLine();
   }
}

/*
This code produces the following output.

Initial contents of the StringDictionary:
   KEY        VALUE
   green      verde
   red        rojo
   blue       azul

The collection contains the key "red".

The collection does not contain the value "amarillo".

*/

Hinweise

Beim Schlüssel wird die Groß-/Kleinschreibung nicht beachtet. Sie wird vor der Verwendung in Kleinbuchstaben übersetzt.

Diese Methode ist ein O(1)-Vorgang.

Ab dem .NET Framework 2.0 verwendet diese Methode die -Objekte Equals und -Methoden item der Auflistung, um zu bestimmen, ob item vorhanden CompareTo ist. In den früheren Versionen des .NET Framework wurde diese Bestimmung mithilfe der Equals Methoden und CompareTo des item Parameters für die -Objekte in der Auflistung vorgenommen.

Gilt für:

Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

Weitere Informationen