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

정의

지정한 키와 연결된 값을 가져옵니다.Gets the value associated with the specified key.

public:
 bool TryGetValue(TKey key, [Runtime::InteropServices::Out] TValue % value);
public bool TryGetValue (TKey key, out TValue value);
abstract member TryGetValue : 'Key *  -> bool
Public Function TryGetValue (key As TKey, ByRef value As TValue) As Boolean

매개 변수

key
TKey TKey TKey TKey

가져올 값이 있는 키입니다.The key whose value to get.

value
TValue TValue TValue TValue

이 메서드가 반환될 때 지정된 키가 있으면 해당 키와 연결된 값이고, 그렇지 않으면 value 매개 변수의 형식에 대한 기본값입니다.When this method returns, the value associated with the specified key, if the key is found; otherwise, the default value for the type of the value parameter. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.This parameter is passed uninitialized.

반환

IDictionary<TKey,TValue>를 구현하는 개체에 지정한 키가 있는 요소가 포함되어 있으면 true이고, 그렇지 않으면 false입니다.true if the object that implements IDictionary<TKey,TValue> contains an element with the specified key; otherwise, false.

예외

예제

사용 하는 방법을 보여는 TryGetValue 값을 검색 하는 방법입니다.The example shows how to use the TryGetValue method to retrieve values. 프로그램을 사전에 없는 키 값을 자주 사용 하는 경우는 TryGetValue 메서드를 사용 하 여 보다 더 효율적일 수 있습니다는 Item[TKey] 존재 하지 않는 키를 검색 하려고 할 때 예외를 throw 하는 속성 (C# 인덱서).If a program frequently tries key values that are not in a dictionary, the TryGetValue method can be more efficient than using the Item[TKey] property (the indexer in C#), which throws exceptions when attempting to retrieve nonexistent keys.

이 코드는 컴파일 및 실행할 수 있는 더 큰 예제의 일부입니다.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>.

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

설명

이 메서드는의 기능을 결합 합니다 ContainsKey 메서드 및 Item[TKey] 속성입니다.This method combines the functionality of the ContainsKey method and the Item[TKey] property.

키가 없으면 해당 value 매개 변수 형식에 대 한 적절 한 기본값을 가져옵니다 TValue; 예를 들어 정수 형식의 경우 영 (0) false 부울 형식에 대 한 및 null 참조 형식에 대 한 합니다.If the key is not found, then the value parameter gets the appropriate default value for the type TValue; for example, zero (0) for integer types, false for Boolean types, and null for reference types.

적용 대상

추가 정보