DbConnectionStringBuilder.TryGetValue(String, Object) Methode

Definitie

Naamruimte:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Hiermee haalt u een waarde op die overeenkomt met de opgegeven sleutel.DbConnectionStringBuilder

public:
 virtual bool TryGetValue(System::String ^ keyword, [Runtime::InteropServices::Out] System::Object ^ % value);
public virtual bool TryGetValue(string keyword, out object value);
abstract member TryGetValue : string * obj -> bool
override this.TryGetValue : string * obj -> bool
Public Overridable Function TryGetValue (keyword As String, ByRef value As Object) As Boolean

Parameters

keyword
String

De sleutel van het item dat moet worden opgehaald.

value
Object

De waarde die overeenkomt met de keyword.

Retouren

Boolean

true als keyword in de verbindingsreeks is gevonden, false anders.

Uitzonderingen

ArgumentNullException

keyword bevat een null-waarde (Nothing in Visual Basic).

Voorbeelden

In het volgende voorbeeld wordt de TryGetValue methode aangeroepen, waarbij verschillende mogelijke resultaten worden gedemonstreerd.

static void Main()
{
    DbConnectionStringBuilder builder = new DbConnectionStringBuilder();
    builder.ConnectionString =
        "Provider=sqloledb;Data Source=192.168.168.1,1433;" +
        "Network Library=DBMSSOCN;Initial Catalog=pubs;" +
        "Integrated Security=SSPI;";

    // Call TryGetValue method for multiple
    // key names.
    DisplayValue(builder, "Provider");
    DisplayValue(builder, "DATA SOURCE");
    DisplayValue(builder, "InvalidKey");
    DisplayValue(builder, null);

    Console.ReadLine();
}

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

    // Although TryGetValue handles missing keys,
    // it doesn't handle passing in a null
    // key. This example traps for that particular error, but
    // bubbles 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)
    {
        Console.WriteLine("Unable to retrieve value for null key.");
    }
}

Sub Main()
    Dim builder As New DbConnectionStringBuilder
    builder.ConnectionString = "..."

    ' Call TryGetValue method for multiple key names.
    DisplayValue(builder, "Provider")
    DisplayValue(builder, "DATA SOURCE")
    DisplayValue(builder, "InvalidKey")
    DisplayValue(builder, Nothing)

    Console.ReadLine()
End Sub

Private Sub DisplayValue( _
 ByVal builder As DbConnectionStringBuilder, ByVal key As String)
    Dim value As Object

    ' Although TryGetValue handles missing keys,
    ' it doesn't handle passing in a null (Nothing in Visual Basic)
    ' key. This example traps for that particular error, but
    ' bubbles any other unknown exceptions back out to the caller.
    Try
        If builder.TryGetValue(key, value) Then
            Console.WriteLine("{0}={1}", key, value)
        Else
            Console.WriteLine("Unable to retrieve value for '{0}'", key)
        End If
    Catch ex As ArgumentNullException
        Console.WriteLine("Unable to retrieve value for null key.")
    End Try
End Sub

In het voorbeeld worden de volgende resultaten weergegeven:

Provider=sqloledb
DATA SOURCE=192.168.168.1,1433
Unable to retrieve value for //InvalidKey//
Unable to retrieve value for null key.

Opmerkingen

Met de TryGetValue methode kunnen ontwikkelaars veilig een waarde ophalen van een DbConnectionStringBuilder waarde zonder eerst de ContainsKey methode aan te roepen. Omdat TryGetValue er geen uitzondering optreedt wanneer u deze aanroept en een niet-bestaande sleutel doorgeeft, hoeft u niet naar een sleutel te zoeken voordat u de waarde opgeeft. Als u TryGetValue aanroept met een niet-bestaande sleutel, wordt de null-waarde (Nothing in Visual Basic) in de parameter value.

Van toepassing op

Zie ook