OleDbConnectionStringBuilder 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 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()
Initialisiert eine neue Instanz der OleDbConnectionStringBuilder-Klasse.
public:
OleDbConnectionStringBuilder();public OleDbConnectionStringBuilder ();Public Sub New ()Weitere Informationen
Gilt für:
OleDbConnectionStringBuilder(String)
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);public OleDbConnectionStringBuilder (string connectionString);new System.Data.OleDb.OleDbConnectionStringBuilder : string -> System.Data.OleDb.OleDbConnectionStringBuilderPublic 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 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.
