OdbcConnectionStringBuilder Sınıf

Tanım

Ad Alanı:

System.Data.Odbc

Bütünleştirilmiş Kod:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v11.0.0-preview.2.26159.112

Kaynak:

OdbcConnectionStringbuilder.cs

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ı, çeşitli ODBC veritabanları 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ı dizesini ayrıştırarak bağlantı dizesinin içeriğini düzenlemenin çeşitli yollarını gösterir.

using System.Data.Odbc;

class Program
{
    static void Main()
    {
        OdbcConnectionStringBuilder builder = new()
            {
                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");

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

        Console.WriteLine($"protocol = {builder["protocol"].ToString()}");
        Console.WriteLine();

        // 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);
    }
}

Imports System.Data.Odbc

Module Module1
    Sub Main()
        Dim builder As New OdbcConnectionStringBuilder With {
            .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")

        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"

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

        ' 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 değmemiş 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 tüm bağlantı dizesi değerleri 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, sınıfındaki OdbcConnectionStringBuilder ilgili özellikleri ve varsayılan değerleriyle birlikte belirli bilinen anahtarlar listelenir. 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	Mülkiyet	Comment	Varsayılan değer
Driver	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ı dizesindeki Driver herhangi bir değer (değer dışında) noktalı virgül (;)) içeriyorsa, OdbcConnectionStringBuilder değeri bağlantı dizesindeki 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, OdbcConnectionStringBuilder sınıf her 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) doğru bir şekilde iç içe anahtar/değer çiftinden çı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ı dizesidir:

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

Oluşturucular

Name	Description
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

Name	Description
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.
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.

Yöntemler

Name	Description
Clear()	Örneğin içeriğini OdbcConnectionStringBuilder temizler.
ContainsKey(String)	öğesinin OdbcConnectionStringBuilder belirli bir anahtar içerip içermediğini belirler.
Remove(String)	Belirtilen anahtara sahip girdiyi örnekten OdbcConnectionStringBuilder kaldırır.
TryGetValue(String, Object)	Bu OdbcConnectionStringBuilderanahtarından sağlanan anahtara karşılık gelen bir değer alır.

Ayrıca bkz.

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