DbConnectionStringBuilder Třída

Definice

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

Dědičnost

Object

DbConnectionStringBuilder

Odvozené

System.Data.EntityClient.EntityConnectionStringBuilder

System.Data.Odbc.OdbcConnectionStringBuilder

System.Data.OleDb.OleDbConnectionStringBuilder

System.Data.OracleClient.OracleConnectionStringBuilder

System.Data.SqlClient.SqlConnectionStringBuilder

Implementuje

ICollection IDictionary IEnumerable ICustomTypeDescriptor

Příklady

Následující konzolová aplikace vytvoří dva připojovací řetězce, jeden pro databázi Microsoft Jet a druhý pro databázi SQL Server. V každém případě kód použije obecnou DbConnectionStringBuilder třídu k vytvoření připojovací řetězec a pak předá ConnectionString vlastnost DbConnectionStringBuilder instance konstruktoru třídy připojení silného typu. To není povinné. kód mohl také vytvořit jednotlivé instance tvůrce silného typu připojovací řetězec. Příklad také analyzuje existující připojovací řetězec a ukazuje různé způsoby manipulace s obsahem připojovací řetězec.

static void Main()
{
    DbConnectionStringBuilder builder =
        new DbConnectionStringBuilder();
    builder.ConnectionString = @"Data Source=c:\MyData\MyDb.mdb";
    builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
    builder.Add("Jet OLEDB:Database Password", "*******");
    builder.Add("Jet OLEDB:System Database",
        @"c:\MyData\Workgroup.mdb");
    // 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 may 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);user id=*******;" +
        "password=*******;initial catalog=AdventureWorks";
    builder["Server"] = ".";
    builder.Remove("User ID");

    // Note that calling Remove on a nonexistent item doesn't
    // throw an exception.
    builder.Remove("BadItem");

    // Setting the indexer adds the value if
    // necessary.
    builder["Integrated Security"] = true;
    builder.Remove("password");
    builder["User ID"] = "Hello";
    Console.WriteLine(builder.ConnectionString);

    Console.WriteLine("Press Enter to finish.");
    Console.ReadLine();
}

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

    ' 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);user id=*******;" & _
        "password=*******;initial catalog=AdventureWorks"
    builder.Item("Server") = "."
    builder.Remove("User ID")

    ' Note that calling Remove on a nonexistent item doesn't
    ' throw an exception.
    builder.Remove("BadItem")

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

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

Poznámky

Třída DbConnectionStringBuilder poskytuje základní třídu, ze které jsou odvozeny silné připojovací řetězec tvůrci (SqlConnectionStringBuilder, OleDbConnectionStringBuilderatd.). Tvůrci připojovací řetězec umožňují vývojářům programově vytvářet syntakticky správné připojovací řetězce a analyzovat a znovu sestavit existující připojovací řetězce.

Objekt DbConnectionStringBuilder byl definován způsobem, který je nezávislý na databázi. Vzhledem k přidání System.Data.Common oboru názvů vývojáři vyžadují základní třídu, proti které mohou programovat, aby mohli vytvářet připojovací řetězce, které mohou pracovat s libovolnou databází. DbConnectionStringBuilder Proto třída umožňuje uživatelům přiřadit libovolné páry klíč/hodnota a předat výsledné připojovací řetězec zprostředkovateli silného typu. Všichni zprostředkovatelé dat, kteří jsou součástí rozhraní .NET Framework, poskytují třídu silného typu, která dědí z DbConnectionStringBuilder: SqlConnectionStringBuilder, OracleConnectionStringBuilder, OdbcConnectionStringBuildera OleDbConnectionStringBuilder.

Vývojář může sestavovat, přiřazovat a upravovat připojovací řetězce pro libovolného zprostředkovatele. Pro poskytovatele, kteří podporují konkrétní páry klíč/hodnota, poskytuje tvůrce připojovací řetězec vlastnosti silného typu odpovídající známým párům. Aby vývojáři mohli podporovat poskytovatele, kteří vyžadují možnost podpory neznámých hodnot, můžou také poskytovat libovolné páry klíč/hodnota.

Třída DbConnectionStringBuilder implementuje rozhraní ICustomTypeDescriptor. To znamená, že třída spolupracuje s návrháři sady Visual Studio v době návrhu. Když vývojáři používají návrháře k vytváření datových sad se silnými typy a připojení silného typu v sadě Visual Studio, třída připojovací řetězec builderu se silnými typy zobrazí vlastnosti přidružené k jejímu typu a bude mít také převaděče, které mohou mapovat společné hodnoty pro známé klíče.

Vývojáři, kteří potřebují vytvořit připojovací řetězce jako součást aplikací, můžou k sestavení a úpravě připojovacích řetězců použít DbConnectionStringBuilder třídu nebo některý z jejích odvozených ze silného typu. Třída DbConnectionStringBuilder také usnadňuje správu připojovacích řetězců uložených v konfiguračním souboru aplikace.

Vývojáři můžou vytvářet připojovací řetězce pomocí třídy připojovací řetězec builderu silného DbConnectionStringBuilder typu, nebo mohou použít třídu . Nástroj DbConnectionStringBuilder neprovádí žádné kontroly platných párů klíč/hodnota. Proto je možné pomocí této třídy vytvořit neplatné připojovací řetězce. Podporuje SqlConnectionStringBuilder pouze páry klíč-hodnota, které jsou podporovány SQL Server; pokus o přidání neplatných párů vyvolá výjimku.

Add Metoda i Item[] popisovač vlastnosti se pokusí vložit škodlivé položky. Například následující kód správně uniká z vnořené dvojice klíč/hodnota:

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";

Výsledkem je následující připojovací řetězec, který bezpečně zpracovává neplatnou hodnotu:

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

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Metody rozšíření

Platí pro

Viz také

• Připojovací řetězce v ADO.NET
• Přehled ADO.NET