IDictionary<TKey,TValue>.ContainsKey(TKey) IDictionary<TKey,TValue>.ContainsKey(TKey) IDictionary<TKey,TValue>.ContainsKey(TKey) IDictionary<TKey,TValue>.ContainsKey(TKey) Method

정의

지정된 키를 갖는 요소가 IDictionary<TKey,TValue>에 들어 있는지 여부를 결정합니다.Determines whether the IDictionary<TKey,TValue> contains an element with the specified key.

public:
 bool ContainsKey(TKey key);
public bool ContainsKey (TKey key);
abstract member ContainsKey : 'Key -> bool
Public Function ContainsKey (key As TKey) As Boolean

매개 변수

key
TKey TKey TKey TKey

IDictionary<TKey,TValue>에서 찾을 수 있는 키입니다.The key to locate in the IDictionary<TKey,TValue>.

반환

true에 해당 키가 있는 요소가 포함되어 있으면 IDictionary<TKey,TValue>이고, 그렇지 않으면 false입니다.true if the IDictionary<TKey,TValue> contains an element with the key; otherwise, false.

예외

예제

다음 코드 예제를 사용 하는 방법을 보여 줍니다 합니다 ContainsKey 메서드를 호출 하기 전에 키의 존재 여부를 테스트 합니다 Add 메서드.The following code example shows how to use the ContainsKey method to test whether a key exists prior to calling the Add method. 또한 사용 하는 방법을 보여 줍니다는 TryGetValue 메서드를 더 효율적으로 프로그램을 사전에 없는 키 값을 자주 사용 하는 경우 값을 검색할 수 있습니다.It also shows how to use the TryGetValue method, which can be a more efficient way to retrieve values if a program frequently tries key values that are not in the dictionary. 마지막으로 사용 하 여 항목을 삽입 하는 방법을 보여 줍니다 Item[TKey] 속성 (C# 인덱서).Finally, it shows how to insert items using Item[TKey] property (the indexer in C#).

이 코드는 컴파일 및 실행할 수 있는 더 큰 예제의 일부입니다.This code is part of a larger example that can be compiled and executed. System.Collections.Generic.IDictionary<TKey,TValue>을 참조하세요.See 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

설명

개체의 같음 여부를 결정 하는 방법의 구현을 달라질 수 있습니다. 예를 들어를 List<T> 클래스가 사용 하 Comparer<T>.Default반면를 Dictionary<TKey,TValue> 클래스를 사용 하면 사용자 지정는 IComparer<T> 키를 비교 하는 데 사용할 구현입니다.Implementations can vary in how they determine equality of objects; for example, the List<T> class uses Comparer<T>.Default, whereas the Dictionary<TKey,TValue> class allows the user to specify the IComparer<T> implementation to use for comparing keys.

있습니다 수 있는지 여부에 따라 다양 한 구현이 key 되도록 null합니다.Implementations can vary in whether they allow key to be null.

적용 대상