SqlConnectionStringBuilder Konstruktor

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Overload

SqlConnectionStringBuilder()	Menginisialisasi instans baru kelas SqlConnectionStringBuilder.
SqlConnectionStringBuilder(String)	Menginisialisasi instans baru kelas SqlConnectionStringBuilder. String koneksi yang disediakan menyediakan data untuk informasi koneksi internal instans.

SqlConnectionStringBuilder()

Menginisialisasi instans baru kelas SqlConnectionStringBuilder.

public:
 SqlConnectionStringBuilder();

public SqlConnectionStringBuilder ();

Public Sub New ()

SqlConnectionStringBuilder(String)

Menginisialisasi instans baru kelas SqlConnectionStringBuilder. String koneksi yang disediakan menyediakan data untuk informasi koneksi internal instans.

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

public SqlConnectionStringBuilder (string connectionString);

new Microsoft.Data.SqlClient.SqlConnectionStringBuilder : string -> Microsoft.Data.SqlClient.SqlConnectionStringBuilder

Public Sub New (connectionString As String)

Parameter

connectionString

String

Dasar untuk informasi koneksi internal objek. Diurai ke dalam pasangan nama/nilai. Nama kunci tidak valid menaikkan KeyNotFoundException.

Pengecualian

KeyNotFoundException

Nama kunci tidak valid dalam string koneksi.

FormatException

Nilai tidak valid dalam string koneksi (khususnya, ketika nilai Boolean atau numerik diharapkan tetapi tidak disediakan).

ArgumentException

Yang disediakan connectionString tidak valid.

Contoh

Contoh berikut menyediakan string koneksi SQL Server sederhana di SqlConnectionStringBuilder konstruktor objek, lalu melakukan iterasi melalui semua pasangan kunci/nilai dalam objek. Perhatikan bahwa koleksi menyediakan nilai default untuk setiap item. Perhatikan juga bahwa SqlConnectionStringBuilder kelas mengonversi sinonim untuk kunci terkenal sehingga konsisten dengan nama-nama terkenal.

Catatan

Contoh ini mencakup kata sandi untuk menunjukkan cara SqlConnectionStringBuilder 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 di aplikasi Anda.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd= a!Pass@@";
            Console.WriteLine("Original: " + connectString);
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Modified: " + builder.ConnectionString);
            foreach (string key in builder.Keys)
                Console.WriteLine(key + "=" + builder[key].ToString());
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (System.Collections.Generic.KeyNotFoundException ex)
        {
            Console.WriteLine("KeyNotFoundException: " + ex.Message);
        }
        catch (System.FormatException ex)
        {
            Console.WriteLine("Format exception: " + ex.Message);
        }
    }
}

Keterangan

Kelas SqlConnectionStringBuilder ini menyediakan kumpulan internal tetap pasangan kunci/nilai. Bahkan jika Anda hanya menyediakan subset kecil dari kemungkinan nilai string koneksi di konstruktor, objek selalu menyediakan nilai default untuk setiap pasangan kunci/nilai. ConnectionString Ketika properti objek diambil, string hanya berisi pasangan kunci/nilai di mana nilai bukan nilai default untuk item.