OleDbConnectionStringBuilder.Provider Eigenschaft

  • Referenz

Definition

Namespace:
System.Data.OleDb
Assembly:
System.Data.OleDb.dll
Assembly:
System.Data.dll

Ruft eine Zeichenfolge ab, die den Namen des der internen Verbindungszeichenfolge zugeordneten Datenanbieters enthält, oder legt diese fest.

public:
 property System::String ^ Provider { System::String ^ get(); void set(System::String ^ value); };
public string Provider { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbProviderConverter))]
public string Provider { get; set; }
member this.Provider : string with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbProviderConverter))>]
member this.Provider : string with get, set
Public Property Provider As String

Eigenschaftswert

String

Der Wert der Provider-Eigenschaft bzw. String.Empty, wenn kein Wert angegeben wurde.

Attribute
TypeConverterAttribute

Beispiele

Im folgenden Beispiel werden mehrere OleDbConnectionStringBuilder Instanzen erstellt, die in jedem Fall eine andere Verbindungszeichenfolge an den Konstruktor übergeben. Beachten Sie, wie das Festlegen des Anbieters, der der Verbindung zugeordnet ist, den Satz vordefinierter Schlüssel-/Wertpaare innerhalb der Auflistung des Objekts ändert.

Hinweis

Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von OleDbConnectionStringBuilder mit Verbindungszeichenfolgen. In den Anwendungen wird die Verwendung der Windows-Authentifizierung empfohlen. Wenn Sie ein Kennwort verwenden müssen, schließen Sie kein hartcodiertes Kennwort in die Anwendung ein.

using System.Data.OleDb;

class Program
{
    static void Main()
    {
        try
        {
            // Build an empty instance, just to see
            // the contents of the keys.
            DumpBuilderContents("");

            // Create a SQL Server connection string.
            DumpBuilderContents("Provider=sqloledb;Data Source=(local);" +
                "Initial Catalog=AdventureWorks;" +
                "User Id=ab;Password=Password@1");

            // Create an Access connection string.
            DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" +
                @"Data Source=C:\Sample.mdb");

            // Create an Oracle connection string.
            DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" +
                "User Id=userName;Password=Pass@word1;");

            // Create a Sybase connection string.
            DumpBuilderContents("Provider=ASAProv;Data source=myASA");

            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();
        }
        catch (System.ArgumentException ex)
        {

            Console.WriteLine("Error: " + ex.Message);
        }
    }

    private static void DumpBuilderContents(string connectString)
    {
        OleDbConnectionStringBuilder builder =
            new OleDbConnectionStringBuilder(connectString);
        Console.WriteLine("=================");
        Console.WriteLine("Original connectString   = " + connectString);
        Console.WriteLine("builder.ConnectionString = " + builder.ConnectionString);
        foreach (string key in builder.Keys)
        {
            Console.WriteLine(key + "=" + builder[key].ToString());
        }
    }
}

Imports System.Data.OleDb    

Module Module1
  Sub Main()
    Try
      ' Build an empty instance, just to see
      ' the contents of the keys.
      DumpBuilderContents("")

      ' Create a SQL Server connection string.
      DumpBuilderContents("Provider=sqloledb;Data Source=(local);" & _
       "Initial Catalog=AdventureWorks;" & _
       "User Id=ab;Password=Password@1")

      ' Create an Access connection string.
      DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" & _
       "Data Source=C:\Sample.mdb")

      ' Create an Oracle connection string.
      DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" & _
       "User Id=userName;Password=Pass@word1;")

      ' Create a Sybase connection string.
      DumpBuilderContents("Provider=ASAProv;Data source=myASA")

      Console.WriteLine("Press any key to finish.")
      Console.ReadLine()

    Catch ex As System.ArgumentException
      Console.WriteLine("Error: " & ex.Message)
    End Try
  End Sub

  Private Sub DumpBuilderContents(ByVal connectString As String)
    Dim builder As New OleDbConnectionStringBuilder(connectString)
    Console.WriteLine("=================")
    Console.WriteLine("Original connectString   = " & connectString)
    Console.WriteLine("builder.ConnectionString = " & builder.ConnectionString)
    For Each key As String In builder.Keys
      Console.WriteLine(key & "=" & builder.Item(key).ToString)
    Next
  End Sub
End Module

Hinweise

Wenn der übergebene Wert NULL ist, wenn Sie die Eigenschaft festlegen, wird die Provider-Eigenschaft zurückgesetzt. Wenn der Wert nicht festgelegt wurde und der Entwickler versucht, die Eigenschaft abzurufen, lautet String.Emptyder Rückgabewert . Diese Eigenschaft entspricht dem Schlüssel "Anbieter" innerhalb der Verbindungszeichenfolge.

Das Festlegen des Werts der Eigenschaft, entweder direkt (durch Festlegen ConnectionString der Eigenschaft) oder durch Übergeben einer Verbindungszeichenfolge als Parameter an den Konstruktor kann sich auf den Satz von Provider Schlüssel-/Wertpaaren auswirken, die in der OleDbConnectionStringBuilder Instanz enthalten sind. Wenn Sie die Provider Eigenschaft auf "sqloledb" festlegen, fügt beispielsweise alle standard-SQL Verbindungszeichenfolgeneigenschaften hinzu. Siehe das Beispiel in diesem Thema für eine Demonstration dieses Verhaltens.

Bei einigen Anbietern führt das Zuweisen einer Verbindungszeichenfolge innerhalb des OleDbConnectionStringBuilder Konstruktors dazu, dass die Reihenfolge der angegebenen Schlüssel-/Wertpaare neu angeordnet wird.

Gilt für

Siehe auch