OleDbConnectionStringBuilder.Provider Properti

Definisi

Ruang nama:

System.Data.OleDb

Rakitan:

System.Data.OleDb.dll

Paket:

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

Sumber:

OleDbConnectionStringBuilder.cs

Mendapatkan atau mengatur string yang berisi nama penyedia data yang terkait dengan string koneksi internal.

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

Nilai Properti

String

Nilai Provider properti , atau String.Empty jika tidak ada yang disediakan.

Atribut

TypeConverterAttribute

Contoh

Contoh berikut membuat beberapa OleDbConnectionStringBuilder instans, meneruskan string koneksi yang berbeda ke konstruktor dalam setiap kasus. Perhatikan cara mengatur penyedia yang terkait dengan koneksi mengubah kumpulan pasangan kunci/nilai yang telah ditentukan sebelumnya dalam koleksi objek.

Catatan

Contoh ini mencakup kata sandi untuk menunjukkan cara OleDbConnectionStringBuilder kerja dengan string koneksi. Di aplikasi Anda, kami sarankan Anda menggunakan Autentikasi Windows. Jika Anda harus menggunakan kata sandi, jangan sertakan kata sandi yang dikodekan secara permanen dalam aplikasi Anda.

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

Keterangan

Jika nilai yang diteruskan null saat Anda mencoba mengatur properti, Provider properti akan diatur ulang. Jika nilai belum ditetapkan dan pengembang mencoba mengambil properti , nilai yang dikembalikan adalah String.Empty. Properti ini sesuai dengan kunci "Penyedia" dalam string koneksi.

Mengatur nilai Provider properti, baik secara langsung (dengan mengatur ConnectionString properti) atau dengan meneruskan string koneksi sebagai parameter ke konstruktor, dapat memengaruhi kumpulan pasangan kunci/nilai yang terkandung dalam OleDbConnectionStringBuilder instans. Provider Mengatur properti ke "sqloledb," misalnya, menambahkan semua properti string koneksi SQL standar. Lihat contoh dalam topik ini untuk demonstrasi perilaku ini.

Untuk beberapa penyedia, menetapkan string koneksi dalam OleDbConnectionStringBuilder konstruktor menyebabkan urutan pasangan kunci/nilai yang disediakan diatur ulang.

Lihat juga

• Pembangun String Koneksi
• String Koneksi dalam ADO.NET