Dictionary<TKey,TValue>.ContainsKey(TKey) Yöntem

Tanım

Ad Alanı:

System.Collections.Generic

Bütünleştirilmiş Kod:

System.Collections.dll

Kaynak:

Dictionary.cs

öğesinin Dictionary<TKey,TValue> belirtilen anahtarı içerip içermediğini belirler.

public:
 virtual bool ContainsKey(TKey key);

public bool ContainsKey (TKey key);

abstract member ContainsKey : 'Key -> bool
override this.ContainsKey : 'Key -> bool

Public Function ContainsKey (key As TKey) As Boolean

Parametreler

key

TKey

içinde Dictionary<TKey,TValue>bulunacak anahtar.

Döndürülenler

Boolean

true belirtilen Dictionary<TKey,TValue> anahtara sahip bir öğe içeriyorsa; değilse, false.

Uygulamalar

ContainsKey(TKey) ContainsKey(TKey)

Özel durumlar

ArgumentNullException

key, null değeridir.

Örnekler

Aşağıdaki kod örneği, yöntemini çağırmadan önce bir anahtarın ContainsKey var olup olmadığını test etmek için yönteminin Add nasıl kullanılacağını gösterir. Ayrıca, bir program sözlükte TryGetValue olmayan anahtarları sık sık denediğinde değerleri almak için etkili bir yol olan değerleri almak için yönteminin nasıl kullanılacağını gösterir. Son olarak, özelliğini (C# dilinde dizin oluşturucu) kullanarak anahtarların Item[] mevcut olup olmadığını test etmenin en az verimli yolunu gösterir.

Bu kod örneği, sınıfı için Dictionary<TKey,TValue> sağlanan daha büyük bir örneğin parçasıdır (openWith bu örnekte kullanılan Sözlüğün adıdır).

// ContainsKey can be used to test keys before inserting
// them.
if (!openWith->ContainsKey("ht"))
{
    openWith->Add("ht", "hypertrm.exe");
    Console::WriteLine("Value added for key = \"ht\": {0}",
        openWith["ht"]);
}

// ContainsKey can be used to test keys before inserting
// them.
if (!openWith.ContainsKey("ht"))
{
    openWith.Add("ht", "hypertrm.exe");
    Console.WriteLine("Value added for key = \"ht\": {0}",
        openWith["ht"]);
}

' ContainsKey can be used to test keys before inserting 
' them.
If Not openWith.ContainsKey("ht") Then
    openWith.Add("ht", "hypertrm.exe")
    Console.WriteLine("Value added for key = ""ht"": {0}", _
        openWith("ht"))
End If

// When a program often has to try keys that turn out not to
// be in the dictionary, TryGetValue can be a more efficient
// way to retrieve values.
String^ value = "";
if (openWith->TryGetValue("tif", value))
{
    Console::WriteLine("For key = \"tif\", value = {0}.", value);
}
else
{
    Console::WriteLine("Key = \"tif\" is not found.");
}

// When a program often has to try keys that turn out not to
// be in the dictionary, TryGetValue can be a more efficient
// way to retrieve values.
string value = "";
if (openWith.TryGetValue("tif", out value))
{
    Console.WriteLine("For key = \"tif\", value = {0}.", value);
}
else
{
    Console.WriteLine("Key = \"tif\" is not found.");
}

' When a program often has to try keys that turn out not to
' be in the dictionary, TryGetValue can be a more efficient 
' way to retrieve values.
Dim value As String = ""
If openWith.TryGetValue("tif", value) Then
    Console.WriteLine("For key = ""tif"", value = {0}.", value)
Else
    Console.WriteLine("Key = ""tif"" is not found.")
End If

// The indexer throws an exception if the requested key is
// not in the dictionary.
try
{
    Console::WriteLine("For key = \"tif\", value = {0}.",
        openWith["tif"]);
}
catch (KeyNotFoundException^)
{
    Console::WriteLine("Key = \"tif\" is not found.");
}

// The indexer throws an exception if the requested key is
// not in the dictionary.
try
{
    Console.WriteLine("For key = \"tif\", value = {0}.",
        openWith["tif"]);
}
catch (KeyNotFoundException)
{
    Console.WriteLine("Key = \"tif\" is not found.");
}

' The default Item property throws an exception if the requested
' key is not in the dictionary.
Try
    Console.WriteLine("For key = ""tif"", value = {0}.", _
        openWith("tif"))
Catch 
    Console.WriteLine("Key = ""tif"" is not found.")
End Try

Açıklamalar

Bu yöntem bir O(1) işlemine yaklaşır.

Ayrıca bkz.

• ContainsValue(TValue)