OleDbConnectionStringBuilder Konstruktoren

Definition

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v8.0.0

Initialisiert eine neue Instanz der OleDbConnectionStringBuilder-Klasse.

Überlädt

OleDbConnectionStringBuilder()	Initialisiert eine neue Instanz der OleDbConnectionStringBuilder-Klasse.
OleDbConnectionStringBuilder(String)	Initialisiert eine neue Instanz der OleDbConnectionStringBuilder-Klasse. Die bereitgestellte Verbindungszeichenfolge stellt die Daten für die internen Verbindungsinformationen der Instanz bereit.

OleDbConnectionStringBuilder()

Quelle:

OleDbConnectionStringBuilder.cs

Initialisiert eine neue Instanz der OleDbConnectionStringBuilder-Klasse.

public:
 OleDbConnectionStringBuilder();

public OleDbConnectionStringBuilder ();

Public Sub New ()

Weitere Informationen

• Verbindungszeichenfolgen-Generatoren
• Verbindungszeichenfolgen in ADO.NET

OleDbConnectionStringBuilder(String)

Quelle:

OleDbConnectionStringBuilder.cs

Initialisiert eine neue Instanz der OleDbConnectionStringBuilder-Klasse. Die bereitgestellte Verbindungszeichenfolge stellt die Daten für die internen Verbindungsinformationen der Instanz bereit.

public:
 OleDbConnectionStringBuilder(System::String ^ connectionString);

public OleDbConnectionStringBuilder (string? connectionString);

new System.Data.OleDb.OleDbConnectionStringBuilder : string -> System.Data.OleDb.OleDbConnectionStringBuilder

Public Sub New (connectionString As String)

Parameter

connectionString

String

Die Grundlage für die internen Verbindungsinformationen der Objekte. Analysiert in Schlüssel-Wert-Paare.

Ausnahmen

ArgumentException

Die Verbindungszeichenfolge ist falsch formatiert (möglicherweise fehlt das erforderliche "=" innerhalb eines Schlüssel-Wert-Paares).

Beispiele

Im folgenden Beispiel werden mehrere OleDbConnectionStringBuilder Instanzen erstellt, wobei jeweils eine andere Verbindungszeichenfolge an den Konstruktor übergeben wird. Beachten Sie, wie das Festlegen des der Verbindung zugeordneten Anbieters den Satz vordefinierter Schlüssel-Wert-Paare 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 an 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

Das Festlegen der Provider Eigenschaft, entweder direkt (durch Festlegen der ConnectionString -Eigenschaft) oder durch Übergeben eines Verbindungszeichenfolge als Parameter an den Konstruktor, kann sich auf den Satz von Schlüssel-Wert-Paaren auswirken, die in der OleDbConnectionStringBuilder instance enthalten sind. Wenn Sie die Provider -Eigenschaft z. B. auf "sqloledb" festlegen, werden alle Standardeigenschaften von SQL Verbindungszeichenfolge hinzugefügt. Eine Demonstration dieses Verhaltens finden Sie im Beispiel in diesem Thema.

Bei einigen Anbietern bewirkt das Zuweisen eines Verbindungszeichenfolge innerhalb des OleDbConnectionStringBuilder Konstruktors, dass die Reihenfolge der angegebenen Schlüssel-Wert-Paare neu angeordnet wird.

Weitere Informationen

• Verbindungszeichenfolgen-Generatoren
• Verbindungszeichenfolgen in ADO.NET