영어로 읽기

다음을 통해 공유


OdbcConnectionStringBuilder.TryGetValue(String, Object) 메서드

정의

OdbcConnectionStringBuilder에서 제공된 키에 해당하는 값을 검색합니다.

public override bool TryGetValue(string keyword, out object? value);
public override bool TryGetValue(string keyword, out object value);

매개 변수

keyword
String

검색할 항목의 키입니다.

value
Object

keyword에 해당하는 값입니다.

반환

keyword가 연결 문자열에 있으면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 동작을 보여 줍니다.는 TryGetValue 메서드.

using System.Data.Odbc;

class Program
{
    static void Main()
    {
        OdbcConnectionStringBuilder builder =
            new OdbcConnectionStringBuilder();
        builder.ConnectionString = GetConnectionString();

        // Call TryGetValue method for multiple
        // key names. Demonstrate that the search is not
        // case sensitive.
        DisplayValue(builder, "Driver");
        DisplayValue(builder, "SERVER");
        // How about a property you did not set?
        DisplayValue(builder, "DNS");
        // Invalid keys?
        DisplayValue(builder, "Invalid Key");
        // Null values?
        DisplayValue(builder, null);

        Console.WriteLine("Press any key to continue.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file using the
        // System.Configuration.ConfigurationSettings.AppSettings property.
        return "Driver={SQL Server};Server=(local);" +
            "Database=AdventureWorks;Trusted_Connection=yes;";
    }

    private static void DisplayValue(OdbcConnectionStringBuilder builder, string key)
    {
        object value = null;

        // Although TryGetValue handles missing keys,
        // it does not handle passing in a null (Nothing in Visual Basic)
        // key. This example traps for that particular error, but
        // throws any other unknown exceptions back out to the
        // caller.
        try
        {
            if (builder.TryGetValue(key, out value))
            {
                Console.WriteLine("{0}='{1}'", key, value);
            }
            else
            {
                Console.WriteLine("Unable to retrieve value for '{0}'", key);
            }
        }
        catch (ArgumentNullException ex)
        {
            Console.WriteLine("Unable to retrieve value for null key.");
        }
    }
}

설명

TryGetValue 메서드를 사용하면 제공된 키 이름이 올바른 키 이름인지 확인하지 않고도 OdbcConnectionStringBuilder에서 값을 안전하게 검색할 수 있습니다. TryGetValue 존재하지 않는 키를 전달할 때 예외가 발생하지 않으므로 해당 값을 검색하기 전에 키를 찾을 필요가 없습니다. 존재하지 않는 키를 사용하여 를 호출 TryGetValue 하면 값 null(Nothing Visual Basic의 경우)이 매개 변수에 value 배치됩니다.

적용 대상

제품 버전
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 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 (package-provided)

추가 정보