DbConnectionStringBuilder.ConnectionString Properti

  • Referensi

Definisi

Ruang nama:
System.Data.Common
Rakitan:
System.Data.Common.dll
Rakitan:
System.Data.dll
Rakitan:
netstandard.dll
Sumber:
DbConnectionStringBuilder.cs
Sumber:
DbConnectionStringBuilder.cs
Sumber:
DbConnectionStringBuilder.cs

Mendapatkan atau mengatur string koneksi yang terkait dengan DbConnectionStringBuilder.

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Property ConnectionString As String

Nilai Properti

String

string koneksi saat ini, dibuat dari pasangan kunci/nilai yang terkandung dalam DbConnectionStringBuilder. Nilai default-nya adalah untaian kosong.

Pengecualian

ArgumentException

Argumen string koneksi tidak valid telah disediakan.

Contoh

Contoh berikut menunjukkan kemungkinan perilaku ConnectionString properti. Contohnya:

  • Membuat string koneksi dengan menambahkan pasangan kunci/nilai, satu per satu, ke kosongDbConnectionStringBuilder.

  • Menetapkan string koneksi lengkap ke ConnectionString properti DbConnectionStringBuilder instans, dan memodifikasi satu pasangan kunci/nilai dalam string.

  • Menetapkan sekumpulan pasangan kunci/nilai arbitrer ke ConnectionString properti (yaitu, string yang bukan apa pun dari jarak jauh seperti string koneksi), dan memodifikasi salah satu nilai.

  • Menetapkan string koneksi yang tidak valid ke ConnectionString properti , menunjukkan pengecualian yang dilemparkan.

Catatan

Contoh ini mencakup kata sandi untuk menunjukkan cara DbConnectionStringBuilder 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.

static void Main()
{
    // Create a new DbConnctionStringBuilder, and add items
    // to the internal collection of key/value pairs.
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder.Add("Data Source", @"c:\MyData\MyDb.mdb");
    builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
    builder.Add("Jet OLEDB:Database Password", "********");
    builder.Add("Jet OLEDB:System Database",
        @"c:\MyData\Workgroup.mdb");

    // Set up row-level locking.
    builder.Add("Jet OLEDB:Database Locking Mode", 1);
    // Display the contents of the connection string, which
    // will now contain all the key/value pairs delimited with
    // semicolons.
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();
    // Clear the DbConnectionStringBuilder, and assign a complete
    // connection string to it, to demonstrate how
    // the class parses connection strings.
    builder.Clear();
    builder.ConnectionString =
        "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI";
    // The DbConnectionStringBuilder class has parsed the contents,
    // so you can work with any individual key/value pair.
    builder["Data Source"] = ".";
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();
    // Because the DbConnectionStringBuilder class doesn't
    // validate its key/value pairs, you can use this class
    // to store any semicolon-delimited list. The following
    // snippet places an arbitrary string into the ConnectionString
    // property, changes one of the values, and then displays the
    // resulting string.
    builder.Clear();
    builder.ConnectionString =
        "Value1=10;Value2=20;Value3=30;Value4=40";
    builder["Value2"] = 25;
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();

    builder.Clear();
    try
    {
        // Assigning an invalid connection string
        // throws an ArgumentException.
        builder.ConnectionString = "xxx";
    }
    catch (ArgumentException)
    {
        Console.WriteLine("Invalid connection string.");
    }

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

Sub Main()
    ' Create a new DbConnctionStringBuilder, and add items
    ' to the internal collection of key/value pairs.
    Dim builder As New DbConnectionStringBuilder()
    builder.Add("Data Source", "c:\MyData\MyDb.mdb")
    builder.Add("Provider", "Microsoft.Jet.Oledb.4.0")
    builder.Add("Jet OLEDB:Database Password", "*******")
    builder.Add("Jet OLEDB:System Database", _
        "c:\MyData\Workgroup.mdb")
    ' Set up row-level locking.
    builder.Add("Jet OLEDB:Database Locking Mode", 1)

    ' Display the contents of the connection string, which
    ' will now contain all the key/value pairs delimited with
    ' semicolons.
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Clear the DbConnectionStringBuilder, and assign a complete
    ' connection string to it, to demonstrate how
    ' the class parses connection strings.
    builder.Clear()
    builder.ConnectionString = _
        "Data Source=(local);Initial Catalog=AdventureWorks;" & _
        "Integrated Security=SSPI"

    ' The DbConnectionStringBuilder class has parsed the contents, 
    ' so you can work with any individual key/value pair.
    builder("Data Source") = "."
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Because the DbConnectionStringBuilder class doesn't 
    ' validate its key/value pairs, you can use this class
    ' to store any semicolon-delimited list. The following
    ' snippet places an arbitrary string into the ConnectionString
    ' property, changes one of the values, and then displays the
    ' resulting string.
    builder.Clear()
    builder.ConnectionString = _
        "Value1=10;Value2=20;Value3=30;Value4=40"
    builder("Value2") = 25
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    builder.Clear()
    Try
        ' Assigning an invalid connection string
        ' throws an ArgumentException.
        builder.ConnectionString = "xxx"

    Catch ex As ArgumentException
        Console.WriteLine("Invalid connection string.")
    End Try

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

Keterangan

Properti ini mengembalikan daftar pasangan kunci/nilai yang dibatasi titik koma yang disimpan dalam koleksi yang dikelola oleh DbConnectionStringBuilder. Setiap pasangan berisi kunci dan nilai, dipisahkan oleh tanda sama dengan. Contoh berikut mengilustrasikan string koneksi umum.

"Persist Security Info=False;Integrated Security=SSPI;Initial Catalog=AdventureWorks;Data Source=(local)"

Penyedia data mungkin mengharapkan kunci dan nilai tertentu untuk setiap properti string koneksi. , Nilai-nilai ini di dokumentasikan satu per satu. Kelas DbConnectionStringBuilder tidak memvalidasi pasangan kunci/nilai yang terkait dengan string koneksi-nya, meskipun kelas yang mewarisinya dapat.

ConnectionString Properti kelas DbConnectionStringBuilder bertindak umumnya sebagai mekanisme untuk membuat dan mengurai daftar pasangan kunci/nilai yang dibatasi titik koma yang dipisahkan dengan tanda yang sama. Ini tidak menyediakan validasi atau dukungan lain khusus untuk string koneksi. Jika Anda menambahkan item ke DbConnectionStringBuilder koleksi, ConnectionString properti akan mencerminkan perubahan. Jika Anda menetapkan nilai ke ConnectionString properti , DbConnectionStringBuilder akan mencoba mengurai nilai, menggunakan pemisah titik koma dan tanda sama dengan.

Berlaku untuk

Lihat juga