DbConnectionStringBuilder Klasse

Definition

public ref class DbConnectionStringBuilder : System::Collections::IDictionary

public ref class DbConnectionStringBuilder : System::Collections::IDictionary, System::ComponentModel::ICustomTypeDescriptor

public class DbConnectionStringBuilder : System.Collections.IDictionary

public class DbConnectionStringBuilder : System.Collections.IDictionary, System.ComponentModel.ICustomTypeDescriptor

type DbConnectionStringBuilder = class
    interface ICollection
    interface IEnumerable
    interface IDictionary

type DbConnectionStringBuilder = class
    interface ICollection
    interface IEnumerable
    interface IDictionary
    interface ICustomTypeDescriptor

type DbConnectionStringBuilder = class
    interface IDictionary
    interface ICollection
    interface IEnumerable
    interface ICustomTypeDescriptor

Public Class DbConnectionStringBuilder
Implements IDictionary

Public Class DbConnectionStringBuilder
Implements ICustomTypeDescriptor, IDictionary

Vererbung

Object

DbConnectionStringBuilder

Abgeleitet

System.Data.EntityClient.EntityConnectionStringBuilder

System.Data.Odbc.OdbcConnectionStringBuilder

System.Data.OleDb.OleDbConnectionStringBuilder

System.Data.OracleClient.OracleConnectionStringBuilder

System.Data.SqlClient.SqlConnectionStringBuilder

Implementiert

ICollection IDictionary IEnumerable ICustomTypeDescriptor

Beispiele

Die folgende Konsolenanwendung erstellt zwei Verbindungszeichenfolgen, eine für eine Microsoft Jet-Datenbank und eine für eine SQL Server-Datenbank. In jedem Fall verwendet der Code eine generische DbConnectionStringBuilder Klasse, um die Verbindungszeichenfolge zu erstellen, und übergibt dann die ConnectionString-Eigenschaft der DbConnectionStringBuilder Instanz an den Konstruktor der stark typierten Verbindungsklasse. Dies ist nicht erforderlich; Der Code könnte auch einzelne stark typierte Verbindungszeichenfolgen-Generator-Instanzen erstellt haben. Im Beispiel wird auch eine vorhandene Verbindungszeichenfolge analysiert und verschiedene Möglichkeiten zum Bearbeiten des Inhalts der Verbindungszeichenfolge veranschaulicht.

DbConnectionStringBuilder builder =
    new DbConnectionStringBuilder();
builder.ConnectionString = @"Data Source=c:\MyData\MyDb.mdb";
builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
// Set up row-level locking.
builder.Add("Jet OLEDB:Database Locking Mode", 1);

// The DbConnectionStringBuilder class
// is database agnostic, so it's possible to
// build any type of connection string using
// this class.

// The ConnectionString property might have been
// formatted by the DbConnectionStringBuilder class.
OleDbConnection oledbConnect = new
    OleDbConnection(builder.ConnectionString);
Console.WriteLine(oledbConnect.ConnectionString);

// Use the same DbConnectionStringBuilder to create
// a SqlConnection object.
builder.Clear();
builder.Add("integrated security", true);
builder.Add("Initial Catalog", "AdventureWorks");
builder.Add("Data Source", "(local)");

SqlConnection sqlConnect = new
    SqlConnection(builder.ConnectionString);
Console.WriteLine(sqlConnect.ConnectionString);

// Pass the DbConnectionStringBuilder an existing
// connection string, and you can retrieve and
// modify any of the elements.
builder.ConnectionString = "server=(local);initial catalog=AdventureWorks";
builder["Server"] = ".";

// Setting the indexer adds the value, if necessary.
builder["Integrated Security"] = true;
Console.WriteLine(builder.ConnectionString);

Sub Main()
    Dim builder As New DbConnectionStringBuilder()
    builder.ConnectionString = "Data Source=c:\MyData\MyDb.mdb"
    builder.Add("Provider", "Microsoft.Jet.Oledb.4.0")

    ' Set up row-level locking.
    builder.Add("Jet OLEDB:Database Locking Mode", 1)

    ' Note that the DbConnectionStringBuilder class
    ' is database agnostic, and it's possible to
    ' build any type of connection string using
    ' this class.
    ' Notice that the ConnectionString property may have been
    ' formatted by the DbConnectionStringBuilder class.

    Dim oledbConnect As New _
        OleDbConnection(builder.ConnectionString)
    Console.WriteLine(oledbConnect.ConnectionString)

    ' Use the same DbConnectionStringBuilder to create
    ' a SqlConnection object.
    builder.Clear()
    builder.Add("integrated security", True)
    builder.Add("Initial Catalog", "AdventureWorks")
    builder.Add("Data Source", "(local)")

    Dim sqlConnect As New SqlConnection(builder.ConnectionString)
    Console.WriteLine(sqlConnect.ConnectionString)

    ' Pass the DbConnectionStringBuilder an existing
    ' connection string, and you can retrieve and
    ' modify any of the elements.
    builder.ConnectionString = "server=(local);initial catalog=AdventureWorks"
    builder.Item("Server") = "."

    ' The Item property is the default for the class,
    ' and setting the Item property adds the value if
    ' necessary.
    builder("Integrated Security") = True
    Console.WriteLine(builder.ConnectionString)

    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
End Sub

Hinweise

Die DbConnectionStringBuilder-Klasse stellt die Basisklasse bereit, von der die stark typierten Verbindungszeichenfolgen-Generatoren (SqlConnectionStringBuilder, OleDbConnectionStringBuilderusw.) abgeleitet sind. Mit den Verbindungszeichenfolgen-Generatoren können Entwickler syntaktisch korrekte Verbindungszeichenfolgen programmgesteuert erstellen und vorhandene Verbindungszeichenfolgen analysieren und neu erstellen.

Die DbConnectionStringBuilder wurde auf datenbankunabhängige Weise definiert. Aufgrund des Hinzufügens des System.Data.Common-Namespaces benötigen Entwickler eine Basisklasse, mit der sie programmieren können, um Verbindungszeichenfolgen zu erstellen, die für eine beliebige Datenbank funktionieren können. Daher können Benutzer mit der DbConnectionStringBuilder Klasse beliebige Schlüssel-Wert-Paare zuweisen und die resultierende Verbindungszeichenfolge an einen stark typierten Anbieter übergeben. Alle Datenanbieter, die als Teil von .NET enthalten sind, bieten eine stark typierte Klasse, die von DbConnectionStringBuildererbt: SqlConnectionStringBuilder, OracleConnectionStringBuilder, OdbcConnectionStringBuilderund OleDbConnectionStringBuilder.

Sie können Verbindungszeichenfolgen für jeden beliebigen Anbieter erstellen, zuweisen und bearbeiten. Für Anbieter, die bestimmte Schlüssel-Wert-Paare unterstützen, stellt der Verbindungszeichenfolgen-Generator stark typierte Eigenschaften bereit, die den bekannten Paaren entsprechen. Für Anbieter, die die Möglichkeit benötigen, unbekannte Werte zu unterstützen, können Sie auch beliebige Schlüssel-Wert-Paare angeben.

Die DbConnectionStringBuilder Klasse implementiert die ICustomTypeDescriptor Schnittstelle. Dies bedeutet, dass die Klasse zur Entwurfszeit mit Visual Studio-Designern arbeitet. Wenn Entwickler den Designer verwenden, um stark typierte DataSets und stark typierte Verbindungen in Visual Studio zu erstellen, zeigt die stark typierte Verbindungszeichenfolgen-Generatorklasse die Eigenschaften an, die ihrem Typ zugeordnet sind, und verfügt auch über Konverter, die allgemeine Werte für bekannte Schlüssel zuordnen können.

Wenn Sie Verbindungszeichenfolgen als Teil von Anwendungen erstellen müssen, verwenden Sie die DbConnectionStringBuilder Klasse oder eine der stark typisierten Ableitungen, um Verbindungszeichenfolgen zu erstellen und zu ändern. Die DbConnectionStringBuilder Klasse erleichtert auch die Verwaltung von Verbindungszeichenfolgen, die in einer Anwendungskonfigurationsdatei gespeichert sind.

Sie können Verbindungszeichenfolgen entweder mithilfe einer stark typierten Verbindungszeichenfolgen-Generatorklasse oder der DbConnectionStringBuilder-Klasse erstellen. Die DbConnectionStringBuilder führt keine Überprüfungen nach gültigen Schlüssel-Wert-Paaren durch. Daher ist es möglich, bei Verwendung dieser Klasse ungültige Verbindungszeichenfolgen zu erstellen. Die SqlConnectionStringBuilder unterstützt nur Schlüssel-Wert-Paare, die von SQL Server unterstützt werden. Wenn Sie versuchen, ungültige Paare hinzuzufügen, wird eine Ausnahme ausgelöst.

Sowohl die Add-Methode als auch Item[] Eigenschaft behandeln Fälle, in denen ein ungültiger Akteur versucht, schädliche Einträge einzufügen. Mit dem folgenden Code wird z. B. das geschachtelte Schlüssel-Wert-Paar ordnungsgemäß escapet:

Dim builder As New System.Data.Common.DbConnectionStringBuilder
builder("Data Source") = "(local)"
builder("integrated sSecurity") = True
builder("Initial Catalog") = "AdventureWorks;NewValue=Bad"

System.Data.Common.DbConnectionStringBuilder builder = new System.Data.Common.DbConnectionStringBuilder();
builder["Data Source"] = "(local)";
builder["integrated Security"] = true;
builder["Initial Catalog"] = "AdventureWorks;NewValue=Bad";

Das Ergebnis ist die folgende Verbindungszeichenfolge, die den ungültigen Wert auf sichere Weise behandelt:

data source=(local);integrated security=True;
initial catalog="AdventureWorks;NewValue=Bad"

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für:

Weitere Informationen

• Verbindungszeichenfolgen in ADO.NET
• ADO.NET Übersicht