OleDbConnectionStringBuilder Oluşturucular

Tanım

Ad Alanı:

System.Data.OleDb

Bütünleştirilmiş Kod:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v9.0.0-preview.6.24327.7

OleDbConnectionStringBuilder sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

OleDbConnectionStringBuilder()	OleDbConnectionStringBuilder sınıfının yeni bir örneğini başlatır.
OleDbConnectionStringBuilder(String)	OleDbConnectionStringBuilder 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.

OleDbConnectionStringBuilder()

Kaynak:

OleDbConnectionStringBuilder.cs

OleDbConnectionStringBuilder sınıfının yeni bir örneğini başlatır.

public:
 OleDbConnectionStringBuilder();

public OleDbConnectionStringBuilder ();

Public Sub New ()

Ayrıca bkz.

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

OleDbConnectionStringBuilder(String)

Kaynak:

OleDbConnectionStringBuilder.cs

OleDbConnectionStringBuilder 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.

public:
 OleDbConnectionStringBuilder(System::String ^ connectionString);

public OleDbConnectionStringBuilder (string? connectionString);

new System.Data.OleDb.OleDbConnectionStringBuilder : string -> System.Data.OleDb.OleDbConnectionStringBuilder

Public Sub New (connectionString As String)

Parametreler

connectionString

String

Nesnenin iç bağlantı bilgilerinin temeli. Anahtar/değer çiftlerine ayrıştırılır.

Özel durumlar

ArgumentException

bağlantı dizesi yanlış biçimlendirildi (anahtar/değer çiftinde gerekli "=" eksik olabilir).

Örnekler

Aşağıdaki örnek, her durumda oluşturucuya farklı bir bağlantı dizesi geçirerek birden çok OleDbConnectionStringBuilder örnek oluşturur. Bağlantıyla ilişkilendirilmiş sağlayıcının ayarlanmasının nesnenin koleksiyonundaki önceden tanımlanmış anahtar/değer çiftleri kümesini nasıl değiştirdiğine dikkat edin.

Not

Bu örnek, bağlantı dizeleriyle nasıl OleDbConnectionStringBuilder ç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.OleDb;

class Program
{
    static void Main()
    {
        try
        {
            // Build an empty instance, just to see
            // the contents of the keys.
            DumpBuilderContents("");

            // Create a SQL Server connection string.
            DumpBuilderContents("Provider=sqloledb;Data Source=(local);" +
                "Initial Catalog=AdventureWorks;" +
                "User Id=ab;Password=Password@1");

            // Create an Access connection string.
            DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" +
                @"Data Source=C:\Sample.mdb");

            // Create an Oracle connection string.
            DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" +
                "User Id=userName;Password=Pass@word1;");

            // Create an Sybase connection string.
            DumpBuilderContents("Provider=ASAProv;Data source=myASA");

            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();
        }
        catch (System.ArgumentException ex)
        {

            Console.WriteLine("Error: " + ex.Message);
        }
    }

    private static void DumpBuilderContents(string connectString)
    {
        OleDbConnectionStringBuilder builder =
            new OleDbConnectionStringBuilder(connectString);
        Console.WriteLine("=================");
        Console.WriteLine("Original connectString   = " + connectString);
        Console.WriteLine("builder.ConnectionString = " + builder.ConnectionString);
        foreach (string key in builder.Keys)
        {
            Console.WriteLine(key + "=" + builder[key].ToString());
        }
    }
}

Imports System.Data.OleDb    

Module Module1
  Sub Main()
    Try
      ' Build an empty instance, just to see
      ' the contents of the keys.
      DumpBuilderContents("")

      ' Create a SQL Server connection string.
      DumpBuilderContents("Provider=sqloledb;Data Source=(local);" & _
       "Initial Catalog=AdventureWorks;" & _
       "User Id=ab;Password=Password@1")

      ' Create an Access connection string.
      DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" & _
       "Data Source=C:\Sample.mdb")

      ' Create an Oracle connection string.
      DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" & _
       "User Id=userName;Password=Pass@word1;")

      ' Create a Sybase connection string.
      DumpBuilderContents("Provider=ASAProv;Data source=myASA")

      Console.WriteLine("Press any key to finish.")
      Console.ReadLine()

    Catch ex As System.ArgumentException
      Console.WriteLine("Error: " & ex.Message)
    End Try
  End Sub

  Private Sub DumpBuilderContents(ByVal connectString As String)
    Dim builder As New OleDbConnectionStringBuilder(connectString)
    Console.WriteLine("=================")
    Console.WriteLine("Original connectString   = " & connectString)
    Console.WriteLine("builder.ConnectionString = " & builder.ConnectionString)
    For Each key As String In builder.Keys
      Console.WriteLine(key & "=" & builder.Item(key).ToString)
    Next
  End Sub
End Module

Açıklamalar

Provider Özelliğin doğrudan ayarlanması (özelliği ayarlayarakConnectionString) veya oluşturucuya parametre olarak bir bağlantı dizesi geçirilerek, örneğin içinde OleDbConnectionStringBuilder yer alan anahtar/değer çiftleri kümesini etkileyebilir. Provider Örneğin, özelliğini "sqloledb" olarak ayarlamak, tüm standart SQL bağlantı dizesi özelliklerini ekler. Bu davranışın bir gösterimi için bu konudaki örne bakın.

Bazı sağlayıcılar için oluşturucu içinde OleDbConnectionStringBuilder bir bağlantı dizesi atanması, sağlanan anahtar/değer çiftlerinin sırasının yeniden düzenlenmesine neden olur.

Ayrıca bkz.

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