OdbcConnectionStringBuilder Sınıf

Tanım

Ad Alanı:

System.Data.Odbc

Bütünleştirilmiş Kod:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-rc.2.24473.5

sınıfı tarafından OdbcConnection kullanılan bağlantı dizelerinin içeriğini oluşturmak ve yönetmek için basit bir yol sağlar.

public ref class OdbcConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

public sealed class OdbcConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

type OdbcConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class OdbcConnectionStringBuilder
Inherits DbConnectionStringBuilder

Devralma

Object

DbConnectionStringBuilder

OdbcConnectionStringBuilder

Örnekler

Aşağıdaki konsol uygulaması, birkaç ODBC veritabanı için bağlantı dizeleri oluşturur. İlk olarak, örnek bir Microsoft Access veritabanı için bir bağlantı dizesi oluşturur. Ardından IBM DB2 veritabanı için bir bağlantı dizesi oluşturur. Örnek ayrıca var olan bir bağlantı dizesi ayrıştırarak bağlantı dizesi içeriğini işlemenin çeşitli yollarını gösterir.

Not

Bu örnek, bağlantı dizeleriyle nasıl OdbcConnectionStringBuilder çalıştığını gösteren bir parola içerir. Uygulamalarınızda Windows Kimlik Doğrulaması kullanmanızı öneririz. Bir parola kullanmanız gerekiyorsa, uygulamanıza sabit kodlanmış bir parola eklemeyin.

using System.Data.Odbc;

class Program
{
    static void Main()
    {
        OdbcConnectionStringBuilder builder =
            new OdbcConnectionStringBuilder();
        builder.Driver = "Microsoft Access Driver (*.mdb)";

        // Call the Add method to explicitly add key/value
        // pairs to the internal collection.
        builder.Add("Dbq", "C:\\info.mdb");
        builder.Add("Uid", "Admin");
        builder.Add("Pwd", "pass!word1");

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();

        // Clear current values and reset known keys to their
        // default values.
        builder.Clear();

        // Pass the OdbcConnectionStringBuilder an existing
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString =
            "driver={IBM DB2 ODBC DRIVER};Database=SampleDB;" +
            "hostname=SampleServerName;port=SamplePortNum;" +
            "protocol=TCPIP;uid=Admin;pwd=pass!word1";

        Console.WriteLine("protocol = "
            + builder["protocol"].ToString());
        Console.WriteLine();

        // Modify existing items.
        builder["uid"] = "NewUser";
        builder["pwd"] = "Pass@word2";

        // Call the Remove method to remove items from
        // the collection of key/value pairs.
        builder.Remove("port");

        // Note that calling Remove on a nonexistent item does not
        // throw an exception.
        builder.Remove("BadItem");
        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();

        // Setting the indexer adds the associated value, if
        // necessary.
        builder["NewKey"] = "newValue";
        Console.WriteLine(builder.ConnectionString);

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

Imports System.Data.Odbc    

Module Module1
  Sub Main()
    Dim builder As New OdbcConnectionStringBuilder()
    builder.Driver = "Microsoft Access Driver (*.mdb)"

    ' Call the Add method to explicitly add key/value
    ' pairs to the internal collection.
    builder.Add("Dbq", "C:\info.mdb")
    builder.Add("Uid", "Admin")
    builder.Add("Pwd", "pass!word1")

    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Clear current values and reset known keys to their
    ' default values.
    builder.Clear()

    ' Pass the OdbcConnectionStringBuilder an existing 
    ' connection string, and you can retrieve and
    ' modify any of the elements.
    builder.ConnectionString = _
        "driver={IBM DB2 ODBC DRIVER};Database=SampleDB;" & _
        "hostname=SampleServerName;port=SamplePortNum;" & _
        "protocol=TCPIP;uid=Admin;pwd=pass!word1"

    Console.WriteLine("protocol = " & builder("protocol").ToString())
    Console.WriteLine()

    ' Modify existing items:
    builder("uid") = "NewUser"
    builder("pwd") = "Pass@word2"

    ' Call the Remove method to remove items from 
    ' the collection of key/value pairs.
    builder.Remove("port")

    ' Note that calling Remove on a nonexistent item does not
    ' throw an exception.
    builder.Remove("BadItem")
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

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

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

Açıklamalar

bağlantı dizesi oluşturucuları, geliştiricilerin program aracılığıyla el dizimsel olarak doğru bağlantı dizeleri oluşturmasına ve sınıfın özelliklerini ve yöntemlerini kullanarak mevcut bağlantı dizelerini ayrıştırıp yeniden oluşturmasına olanak sağlar. bağlantı dizesi oluşturucusu, ODBC bağlantıları tarafından izin verilen bilinen anahtar/değer çiftlerine karşılık gelen kesin olarak belirlenmiş özellikler sağlar ve geliştiriciler diğer bağlantı dizesi değerler için rastgele anahtar/değer çiftleri ekleyebilir.

Uygulamaların bir parçası olarak bağlantı dizeleri oluşturması gereken geliştiriciler, bağlantı dizelerini oluşturmak ve değiştirmek için sınıfını kullanabilir OdbcConnectionStringBuilder . sınıfı, bir uygulama yapılandırma dosyasında depolanan bağlantı dizelerini yönetmeyi de kolaylaştırır. OdbcConnectionStringBuilder yalnızca bilinen anahtar/değer çiftlerinin sınırlı kümesi için denetimler gerçekleştirir. Bu nedenle, bu sınıf geçersiz bağlantı dizeleri oluşturmak için kullanılabilir. Aşağıdaki tabloda, belirli bilinen anahtarlar, sınıfındaki OdbcConnectionStringBuilder ilgili özellikleri ve varsayılan değerleriyle birlikte listelemektedir. Geliştiriciler bu belirli değerlerin yanı sıra, örneğin içinde yer alan koleksiyona herhangi bir anahtar/değer çifti OdbcConnectionStringBuilder ekleyebilir.

Anahtar	Özellik	Yorum	Varsayılan değer
Sürücü	Driver	Geliştiriciler, özelliği ayarlarken sürücü adını çevreleyen küme ayraçlarını Driver içermemelidir. Örnek OdbcConnectionStringBuilder gerektiğinde küme ayraçları ekler.	Boş dize
DSN	Dsn		Boş dize

bağlantı dizesi içindeki herhangi bir değer (değer dışındaDriver) noktalı virgül (;)) içeriyorsa, OdbcConnectionStringBuilder değeri bağlantı dizesi tırnak işaretleri ile çevreler. Bu sorunun sık sık noktalı virgül içeren değerle Driver karşılaşmaması için sınıf her OdbcConnectionStringBuilder zaman bu değeri ayraçlarla çevreler. ODBC belirtimi, noktalı virgül içeren sürücü değerlerinin ayraçlarla çevrelenmiş olması gerektiğini belirtir ve bu sınıf bunu sizin için işler.

özelliği, Item[] kötü amaçlı kod ekleme girişimlerini işler. Örneğin, aşağıdaki kod, varsayılan Item[] özelliği (C# dilinde dizin oluşturucu) kullanarak iç içe anahtar/değer çiftinden doğru bir şekilde çıkış yapar.

Dim builder As _
 New System.Data.Odbc.OdbcConnectionStringBuilder
' Take advantage of the Driver property.
builder.Driver = "SQL Server"
builder("Server") = "MyServer;NewValue=Bad"
Console.WriteLine(builder.ConnectionString)

System.Data.Odbc.OdbcConnectionStringBuilder builder =
  new System.Data.Odbc.OdbcConnectionStringBuilder();
// Take advantage of the Driver property.
builder.Driver = "SQL Server";
builder["Server"] = "MyServer;NewValue=Bad";
Console.WriteLine(builder.ConnectionString);

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

Driver={SQL Server};Server="MyServer;NewValue=Bad"

Oluşturucular

OdbcConnectionStringBuilder()	OdbcConnectionStringBuilder sınıfının yeni bir örneğini başlatır.
OdbcConnectionStringBuilder(String)	OdbcConnectionStringBuilder sınıfının yeni bir örneğini başlatır. Sağlanan bağlantı dizesi, örneğin iç bağlantı bilgileri için verileri sağlar.

Özellikler

BrowsableConnectionString	Özelliğin Visual Studio tasarımcılarında görünür olup olmadığını ConnectionString gösteren bir değer alır veya ayarlar. (Devralındığı yer: DbConnectionStringBuilder)
ConnectionString	ile DbConnectionStringBuilderilişkili bağlantı dizesi alır veya ayarlar. (Devralındığı yer: DbConnectionStringBuilder)
Count	özelliği içinde ConnectionString yer alan geçerli anahtar sayısını alır. (Devralındığı yer: DbConnectionStringBuilder)
Driver	Bağlantıyla ilişkili ODBC sürücüsünün adını alır veya ayarlar.
Dsn	Bağlantıyla ilişkili veri kaynağı adının (DSN) adını alır veya ayarlar.
IsFixedSize	değerinin sabit bir boyuta sahip olup olmadığını DbConnectionStringBuilder belirten bir değer alır. (Devralındığı yer: DbConnectionStringBuilder)
IsReadOnly	öğesinin salt okunur olup olmadığını DbConnectionStringBuilder belirten bir değer alır. (Devralındığı yer: DbConnectionStringBuilder)
Item[String]	Belirtilen anahtarla ilişkili değeri alır veya ayarlar. C# dilinde bu özellik dizin oluşturucudur.
Keys	içindeki OdbcConnectionStringBuilderanahtarları içeren bir ICollection alır.
Values	içindeki DbConnectionStringBuilderdeğerleri içeren bir ICollection alır. (Devralındığı yer: DbConnectionStringBuilder)

Yöntemler

Add(String, Object)	öğesine belirtilen anahtar ve değere DbConnectionStringBuildersahip bir girdi ekler. (Devralındığı yer: DbConnectionStringBuilder)
Clear()	Örneğin içeriğini OdbcConnectionStringBuilder temizler.
ClearPropertyDescriptors()	İlişkili DbConnectionStringBuildernesne koleksiyonunu PropertyDescriptor temizler. (Devralındığı yer: DbConnectionStringBuilder)
ContainsKey(String)	öğesinin OdbcConnectionStringBuilder belirli bir anahtar içerip içermediğini belirler.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
EquivalentTo(DbConnectionStringBuilder)	Bu DbConnectionStringBuilder nesnedeki bağlantı bilgilerini sağlanan nesnedeki bağlantı bilgileriyle karşılaştırır. (Devralındığı yer: DbConnectionStringBuilder)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetProperties(Hashtable)	Sağlanan Hashtable bir öğesini bu DbConnectionStringBuilderöğesinin tüm özellikleri hakkında bilgilerle doldurur. (Devralındığı yer: DbConnectionStringBuilder)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Remove(String)	Belirtilen anahtara sahip girdiyi örnekten OdbcConnectionStringBuilder kaldırır.
ShouldSerialize(String)	Belirtilen anahtarın bu DbConnectionStringBuilder örnekte var olup olmadığını gösterir. (Devralındığı yer: DbConnectionStringBuilder)
ToString()	Bu DbConnectionStringBuilderile ilişkili bağlantı dizesi döndürür. (Devralındığı yer: DbConnectionStringBuilder)
TryGetValue(String, Object)	Bu OdbcConnectionStringBuilderanahtarından sağlanan anahtara karşılık gelen bir değeri alır.

Uzantı Metotları

Ayrıca bkz.

• Bağlantı Dizesi Oluşturucular
• ADO.NET'da Bağlantı Dizeleri