OdbcConnectionStringBuilder Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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()
Initialisiert eine neue Instanz der OdbcConnectionStringBuilder-Klasse.
public:
OdbcConnectionStringBuilder();public OdbcConnectionStringBuilder ();Public Sub New ()Weitere Informationen
Gilt für:
OdbcConnectionStringBuilder(String)
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);public OdbcConnectionStringBuilder (string connectionString);new System.Data.Odbc.OdbcConnectionStringBuilder : string -> System.Data.Odbc.OdbcConnectionStringBuilderPublic Sub New (connectionString As String)Parameter
- connectionString
- String
Die Grundlage für die internen Verbindungsinformationen der Objekte. Analysiert in Schlüssel-Wert-Paare.
Ausnahmen
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.
