DbConnectionStringBuilder Sınıf

Tanım

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

Devralma

Object

DbConnectionStringBuilder

Türetilmiş

System.Data.EntityClient.EntityConnectionStringBuilder

System.Data.Odbc.OdbcConnectionStringBuilder

System.Data.OleDb.OleDbConnectionStringBuilder

System.Data.OracleClient.OracleConnectionStringBuilder

System.Data.SqlClient.SqlConnectionStringBuilder

Uygulamalar

ICollection IDictionary IEnumerable ICustomTypeDescriptor

Örnekler

Aşağıdaki konsol uygulaması biri Microsoft Jet veritabanı, diğeri de SQL Server veritabanı için olmak üzere iki bağlantı dizesi oluşturur. Her durumda kod, bağlantı dizesini oluşturmak için genel bir DbConnectionStringBuilder sınıfı kullanır ve ardından DbConnectionStringBuilder örneğinin ConnectionString özelliğini kesin olarak türü belirlenmiş bağlantı sınıfının oluşturucusunda geçirir. Bu gerekli değildir; kod, tek tek kesin olarak türü belirlenmiş bağlantı dizesi oluşturucu örnekleri de oluşturmuş olabilir. Örnek ayrıca var olan bir bağlantı dizesini ayrıştırarak bağlantı dizesinin içeriğini düzenlemenin çeşitli yollarını gösterir.

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

Açıklamalar

DbConnectionStringBuilder sınıfı, kesin olarak yazılan bağlantı dizesi oluşturucularının (SqlConnectionStringBuilder, OleDbConnectionStringBuildervb.) türetildiği temel sınıfı sağlar. Bağlantı dizesi oluşturucuları, geliştiricilerin program aracılığıyla el dizimsel olarak doğru bağlantı dizeleri oluşturmasına ve mevcut bağlantı dizelerini ayrıştırıp yeniden oluşturmasına olanak sağlar.

DbConnectionStringBuilder, veritabanı belirsiz bir şekilde tanımlanmıştır. System.Data.Common ad alanının eklenmesi nedeniyle geliştiriciler, rastgele bir veritabanında çalışabilen bağlantı dizeleri oluşturmak için programlanabilecekleri bir temel sınıf gerektirir. Bu nedenle, DbConnectionStringBuilder sınıfı kullanıcıların rastgele anahtar/değer çiftleri atamasına ve sonuçta elde edilen bağlantı dizesini kesin olarak belirlenmiş bir sağlayıcıya geçirmesine olanak tanır. .NET'in bir parçası olarak dahil edilen tüm veri sağlayıcıları, DbConnectionStringBuilderdevralan kesin olarak belirlenmiş bir sınıf sunar: SqlConnectionStringBuilder, OracleConnectionStringBuilder, OdbcConnectionStringBuilderve OleDbConnectionStringBuilder.

Herhangi bir rastgele sağlayıcı için bağlantı dizeleri oluşturabilir, atayabilir ve düzenleyebilirsiniz. Belirli anahtar/değer çiftlerini destekleyen sağlayıcılar için bağlantı dizesi oluşturucusu, bilinen çiftlere karşılık gelen kesin olarak belirlenmiş özellikler sağlar. Bilinmeyen değerleri destekleme olanağı gerektiren sağlayıcılar için rastgele anahtar/değer çiftleri de sağlayabilirsiniz.

DbConnectionStringBuilder sınıfı ICustomTypeDescriptor arabirimini uygular. Bu, sınıfın tasarım zamanında Visual Studio tasarımcılarıyla çalıştığı anlamına gelir. Geliştiriciler Visual Studio'da kesin olarak yazılan DataSet'ler ve kesin olarak yazılan bağlantılar oluşturmak için tasarımcıyı kullandığında, kesin olarak yazılan bağlantı dizesi oluşturucu sınıfı türüyle ilişkili özellikleri görüntüler ve ayrıca bilinen anahtarlar için ortak değerleri eşleyebilecek dönüştürücülere sahiptir.

Uygulamaların bir parçası olarak bağlantı dizeleri oluşturmanız gerekiyorsa, bağlantı dizelerini oluşturmak ve değiştirmek için DbConnectionStringBuilder sınıfını veya kesin olarak türü belirlenmiş türevlerinden birini kullanın. DbConnectionStringBuilder sınıfı, bir uygulama yapılandırma dosyasında depolanan bağlantı dizelerini yönetmeyi de kolaylaştırır.

Kesin olarak belirlenmiş bir bağlantı dizesi oluşturucu sınıfını veya DbConnectionStringBuilder sınıfını kullanarak bağlantı dizeleri oluşturabilirsiniz. DbConnectionStringBuilder geçerli anahtar/değer çiftleri için denetim gerçekleştirmez. Bu nedenle, bu sınıfı kullanırken geçersiz bağlantı dizeleri oluşturmak mümkündür. SqlConnectionStringBuilder yalnızca SQL Server tarafından desteklenen anahtar/değer çiftlerini destekler; Geçersiz çiftler eklemeye çalışılırsa bir özel durum oluşturulur.

Hem Add yöntemi hem de Item[] özelliği, kötü amaçlı bir aktörün kötü amaçlı girişler eklemeye çalıştığı durumları işler. Örneğin, aşağıdaki kod iç içe anahtar/değer çiftinden doğru şekilde çıkış yapar:

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

Sonuç, geçersiz değeri güvenli bir şekilde işleyen aşağıdaki bağlantı dizesidir:

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

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır

Ayrıca bkz.

• ADO.NET'da Bağlantı Dizelerini
• ADO.NET Genel Bakış