OleDbConnectionStringBuilder.Provider Eigenschaft
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.
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); };[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbProviderConverter))]
public string Provider { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbProviderConverter))>]
member this.Provider : string with get, setPublic Property Provider As StringEigenschaftswert
Der Wert der Provider-Eigenschaft bzw. String.Empty, wenn kein Wert angegeben wurde.
- Attribute
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 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, ist String.Emptyder Rückgabewert . Diese Eigenschaft entspricht dem Schlüssel "Anbieter" innerhalb des Verbindungszeichenfolge.
Das Festlegen des Werts 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 beispielsweise die Provider Eigenschaft auf "sqloledb" festlegen, werden alle SQL-Standardeigenschaften Verbindungszeichenfolge hinzugefügt. Eine Demonstration dieses Verhaltens finden Sie im Beispiel in diesem Thema.
Bei einigen Anbietern wird durch das Zuweisen eines Verbindungszeichenfolge innerhalb des OleDbConnectionStringBuilder Konstruktors die Reihenfolge der angegebenen Schlüssel-Wert-Paare neu angeordnet.
