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

Tanım

Ad Alanı:

System.Collections.Generic

Bütünleştirilmiş Kod:

System.Runtime.dll

öğesinin IDictionary<TKey,TValue> belirtilen anahtara sahip bir öğe içerip içermediğini belirler.

public:
 bool ContainsKey(TKey key);

public bool ContainsKey (TKey key);

abstract member ContainsKey : 'Key -> bool

Public Function ContainsKey (key As TKey) As Boolean

Parametreler

key

TKey

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

Döndürülenler

Boolean

true anahtarıyla IDictionary<TKey,TValue> bir öğe içeriyorsa; değilse, false.

Ö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 anahtar değerleri sık sık denerse değerleri almak için daha verimli bir yol olabilecek yönteminin nasıl kullanılacağını gösterir. Son olarak, özelliği (C# dilinde dizin oluşturucu) kullanarak Item[] öğelerin nasıl ekleyebileceğinizi gösterir.

Bu kod, derlenip yürütülebilen daha büyük bir örneğin parçasıdır. Bkz. System.Collections.Generic.IDictionary<TKey,TValue>.

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

Uygulamalar nesnelerin eşitliğini belirleme şekline göre farklılık gösterebilir; örneğin, List<T> sınıfı kullanır Comparer<T>.Default, sınıfı ise Dictionary<TKey,TValue> kullanıcının anahtarları karşılaştırmak için kullanılacak uygulamayı belirtmesine IComparer<T> izin verir.

Uygulamalar, olmasına izin key verip vermediklerine nullgöre farklılık gösterebilir.