SqlConnectionStringBuilder Konstruktor

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.9.0

Menginisialisasi instans baru kelas SqlConnectionStringBuilder.

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()

Sumber:

System.Data.SqlClient.notsupported.cs

Menginisialisasi instans baru kelas SqlConnectionStringBuilder.

public:
 SqlConnectionStringBuilder();

public SqlConnectionStringBuilder ();

Public Sub New ()

Lihat juga

• Ringkasan ADO.NET

SqlConnectionStringBuilder(String)

Sumber:

System.Data.SqlClient.notsupported.cs

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 System.Data.SqlClient.SqlConnectionStringBuilder : string -> System.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 memasok SQL Server string koneksi 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 dalam aplikasi Anda.

using System.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);
        }
    }
}

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String = _
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd=a!Pass@@"
            Console.WriteLine("Original: " & connectString)
            Dim builder As New SqlConnectionStringBuilder(connectString)
            Console.WriteLine("Modified: " & builder.ConnectionString)
            For Each key As String In builder.Keys
                Console.WriteLine(key & "=" & builder.Item(key).ToString)
            Next
            Console.WriteLine("Press any key to finish.")
            Console.ReadLine()

        Catch ex As System.Collections.Generic.KeyNotFoundException
            Console.WriteLine("KeyNotFoundException: " & ex.Message)
        Catch ex As System.FormatException
            Console.WriteLine("Format exception: " & ex.Message)
        End Try
    End Sub
End Module

Keterangan

Kelas SqlConnectionStringBuilder ini menyediakan kumpulan internal tetap pasangan kunci/nilai. Bahkan jika Anda hanya menyediakan subset kecil dari nilai string koneksi yang mungkin 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.

Lihat juga

• String Koneksi (ADO.NET)
• Ringkasan ADO.NET