OleDbConnectionStringBuilder.Provider Özellik

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

Kaynak:

OleDbConnectionStringBuilder.cs

İç bağlantı dizesi ile ilişkili veri sağlayıcısının adını içeren bir dize alır veya ayarlar.

public:
 property System::String ^ Provider { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbProviderConverter))]
public string Provider { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbProviderConverter))>]
member this.Provider : string with get, set

Public Property Provider As String

Özellik Değeri

String

özelliğinin Provider değeri veya String.Empty sağlanmamışsa.

Öznitelikler

TypeConverterAttribute

Ö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 a 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

Özelliğini ayarlamaya çalıştığınızda geçirilen değer null ise özellik Provider sıfırlanır. Değer ayarlanmamışsa ve geliştirici özelliği almaya çalışırsa, dönüş değeri olur String.Empty. Bu özellik, bağlantı dizesi içindeki "Sağlayıcı" anahtarına karşılık gelir.

Özelliğin Provider değerini doğrudan (özelliği ayarlayarakConnectionString) veya oluşturucuya parametre olarak bir bağlantı dizesi geçirerek ayarlamak, ö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