OleDbConnectionStringBuilder.TryGetValue(String, Object) Metódus

Definíció

Névtér:
System.Data.OleDb
Szerelvény:
System.Data.OleDb.dll
Szerelvény:
System.Data.dll
Csomag:
System.Data.OleDb v11.0.0-preview.4.26230.115
Forrás:
OleDbConnectionStringBuilder.cs
Forrás:
OleDbConnectionStringBuilder.cs
Forrás:
OleDbConnectionStringBuilder.cs
Forrás:
OleDbConnectionStringBuilder.cs

Lekéri a megadott kulcsnak megfelelő értéket a OleDbConnectionStringBuilder példányból.

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

Paraméterek

keyword
String

A lekérni kívánt elem kulcsa.

value
Object

A következő értéknek megfelelő keywordérték: .

Válaszok

Boolean

true, ha keyword található a kapcsolati karakterlánc; ellenkező esetben false.

Kivételek

ArgumentNullException

keyword null értéket tartalmaz (Nothing Visual Basic).

Példák

Az alábbi példa a metódus viselkedését TryGetValue mutatja be.

using System.Data.OleDb;

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

        // Call TryGetValue method for multiple
        // key names.
        DisplayValue(builder, "Data Source");
        DisplayValue(builder, "Extended Properties");
        // How about implicitly added key/value pairs?
        DisplayValue(builder, "Jet OLEDB:System database");
        // Invalid keys?
        DisplayValue(builder, "Invalid Key");
        // Null values?
        DisplayValue(builder, null);

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

    static private void DisplayValue(OleDbConnectionStringBuilder 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)
        {
            Console.WriteLine("Unable to retrieve value for null key.");
        }
    }

    static private 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 "Provider=Microsoft.Jet.OLEDB.4.0;" +
            "Data Source=C:\\ExcelDemo.xls;" +
            "Extended Properties=\"Excel 8.0;HDR=Yes;IMEX=1\"";
    }
}

Imports System.Data.OleDb    

Module Module1
  Sub Main()
    Dim builder As New OleDbConnectionStringBuilder
    builder.ConnectionString = GetConnectionString()

    ' Call TryGetValue method for multiple
    ' key names. 
    DisplayValue(builder, "Data Source")
    DisplayValue(builder, "Extended Properties")
    ' How about implicitly added key/value pairs?
    DisplayValue(builder, "Jet OLEDB:System database")
    ' Invalid keys?
    DisplayValue(builder, "Invalid Key")
    ' Null values?
    DisplayValue(builder, Nothing)

    Console.WriteLine("Press any key to continue.")
    Console.ReadLine()
  End Sub

  Private Sub DisplayValue( _
   ByVal builder As OleDbConnectionStringBuilder, ByVal key As String)
    Dim value As Object = Nothing

    ' 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, 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

  Private Function GetConnectionString() As String
    ' 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 "Provider=Microsoft.Jet.OLEDB.4.0;" & _
      "Data Source=C:\ExcelDemo.xls;" & _
      "Extended Properties=""Excel 8.0;HDR=Yes;IMEX=1"""
  End Function
End Module

Megjegyzések

A TryGetValue módszer lehetővé teszi, hogy a fejlesztők biztonságosan lekérjenek egy értéket egy OleDbConnectionStringBuilder adott kulcsból anélkül, hogy ellenőrizni kellene, hogy a megadott kulcsnév érvényes kulcsnév-e. Mivel TryGetValue nem emel ki kivételt, amikor meghívja, és nem létező kulcsot ad át, az érték lekérése előtt nem kell keresnie egy kulcsot. Ha a TryGetValue nem létező kulccsal hívja meg, a null értéket (Nothing Visual Basic) helyezi el a value paraméterben.

A következőre érvényes:

Lásd még