OdbcConnectionStringBuilder Konstruktoren

Definition

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-preview.3.24172.9

Initialisiert eine neue Instanz der OdbcConnectionStringBuilder-Klasse.

Überlädt

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

OdbcConnectionStringBuilder()

Quelle:

OdbcConnectionStringbuilder.cs

Initialisiert eine neue Instanz der OdbcConnectionStringBuilder-Klasse.

public:
 OdbcConnectionStringBuilder();

public OdbcConnectionStringBuilder ();

Public Sub New ()

Weitere Informationen

• Verbindungszeichenfolgen-Generatoren
• Verbindungszeichenfolgen in ADO.NET

OdbcConnectionStringBuilder(String)

Quelle:

OdbcConnectionStringbuilder.cs

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

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

public OdbcConnectionStringBuilder (string? connectionString);

new System.Data.Odbc.OdbcConnectionStringBuilder : string -> System.Data.Odbc.OdbcConnectionStringBuilder

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 OdbcConnectionStringBuilder Instanzen erstellt, wobei jeweils eine andere Verbindungszeichenfolge an den Konstruktor übergeben wird. Beachten Sie, dass die Reihenfolge der Elemente innerhalb der Verbindungszeichenfolge beim Abrufen der ConnectionString Eigenschaft geändert werden kann. Beachten Sie außerdem, dass andere Schlüssel als die vordefinierten Schlüssel "Dsn" und "Driver" von der OdbcConnectionStringBuilder Klasse in Kleinbuchstaben konvertiert werden.

Hinweis

Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von OdbcConnectionStringBuilder 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.Odbc;

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("Driver={SQL Server};Server=(local);Database=AdventureWorks;Uid=ab;Pwd=pass@word1");

            // Create an Access connection string.
            DumpBuilderContents(@"Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\info.mdb;Exclusive=1;Uid=admin;Pwd=pass@word1");

            // Create an Oracle connection string.
            DumpBuilderContents("Driver={Microsoft ODBC for Oracle};Server=OracleServer.world;Uid=Admin;Pwd=pass@word1;");

            // Create a Sybase connection string.
            DumpBuilderContents("Driver={SYBASE ASE ODBC Driver};Srvr=SomeServer;Uid=admin;Pwd=pass@word1");

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

    private static void DumpBuilderContents(string connectString)
    {
        OdbcConnectionStringBuilder builder =
            new OdbcConnectionStringBuilder(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.Odbc    

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("Driver={SQL Server};Server=(local);Database=AdventureWorks;Uid=ab;Pwd=pass@word1")

      ' Create an Access connection string.
      DumpBuilderContents("Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\info.mdb;Exclusive=1;Uid=admin;Pwd=pass@word1")

      ' Create an Oracle connection string.
      DumpBuilderContents("Driver={Microsoft ODBC for Oracle};Server=OracleServer.world;Uid=Admin;Pwd=pass@word1;")

      ' Create a Sybase connection string.
      DumpBuilderContents("Driver={SYBASE ASE ODBC Driver};Srvr=SomeServer;Uid=admin;Pwd=pass@word1")

      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 OdbcConnectionStringBuilder(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

Sie können eine Verbindungszeichenfolge im Konstruktor übergeben oder die ConnectionString Eigenschaft explizit festlegen. Das Verhalten ist in beiden Richtungen identisch.

Weitere Informationen

• Verbindungszeichenfolgen-Generatoren
• Verbindungszeichenfolgen in ADO.NET