SqlConnection.ConnectionString Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v7.0.1

Mendapatkan atau mengatur string yang digunakan untuk membuka database SQL Server.

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

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Nilai Properti

String

String koneksi yang menyertakan nama database sumber, dan parameter lain yang diperlukan untuk membuat koneksi awal. Nilai default adalah string kosong.

Atribut

SettingsBindableAttribute

Pengecualian

ArgumentException

Argumen string koneksi tidak valid telah disediakan, atau argumen string koneksi yang diperlukan belum disediakan.

Contoh

Contoh berikut membuat SqlConnection dan mengatur ConnectionString properti sebelum membuka koneksi.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();

        using (SqlConnection connection = new SqlConnection())
        {
            connection.ConnectionString = connectionString;

            connection.Open();

            Console.WriteLine("State: {0}", connection.State);
            Console.WriteLine("ConnectionString: {0}",
                connection.ConnectionString);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file.
        return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
            + "Integrated Security=true;";
    }
}

Contoh berikut membuat SqlConnection dan mengatur ConnectionString properti sebelum membuka koneksi.

using System;
using System.Data;
using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();

        using (SqlConnection connection = new SqlConnection())
        {
            connection.ConnectionString = connectionString;

            connection.Open();

            Console.WriteLine("State: {0}", connection.State);
            Console.WriteLine("ConnectionString: {0}",
                connection.ConnectionString);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file.
        return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
            + "Integrated Security=true;";
    }
}

Keterangan

ConnectionString mirip dengan string koneksi OLE DB, tetapi tidak identik. Tidak seperti OLE DB atau ADO, string koneksi yang dikembalikan sama dengan kumpulan ConnectionStringpengguna , informasi keamanan dikurangi jika nilai Info Keamanan Persist diatur ke false (default). Penyedia Data .NET Framework untuk SQL Server tidak bertahan atau mengembalikan kata sandi dalam string koneksi kecuali Anda mengatur Persist Security Info ke true.
Anda bisa menggunakan ConnectionString properti untuk menyambungkan ke database. Contoh berikut mengilustrasikan string koneksi umum.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"  

Gunakan yang baru SqlConnectionStringBuilder untuk membuat string koneksi yang valid pada waktu proses. Untuk informasi selengkapnya, lihat Pembuat String Koneksi.

Properti ConnectionString hanya dapat diatur ketika koneksi ditutup. Banyak nilai string koneksi memiliki properti baca-saja yang sesuai. Saat string koneksi diatur, properti ini diperbarui, kecuali ketika kesalahan terdeteksi. Dalam hal ini, tidak ada properti yang diperbarui. SqlConnection properti hanya mengembalikan pengaturan yang terkandung dalam ConnectionString.

Untuk menyambungkan ke komputer lokal, tentukan "(lokal)" untuk server. Jika nama server tidak ditentukan, koneksi akan dicoba ke instans default di komputer lokal.

Mengatur ConnectionString ulang pada koneksi tertutup mengatur ulang semua nilai string koneksi (dan properti terkait) termasuk kata sandi. Misalnya, jika Anda mengatur string koneksi yang menyertakan "Database= AdventureWorks", lalu mengatur ulang string koneksi ke "Sumber Data=myserver; Integrated Security=true", Database properti tidak lagi diatur ke "AdventureWorks".

String koneksi diurai segera setelah diatur. Jika kesalahan dalam sintaks ditemukan saat mengurai, pengecualian runtime, seperti ArgumentException, dihasilkan. Kesalahan lain hanya dapat ditemukan ketika upaya dilakukan untuk membuka koneksi.

Format dasar string koneksi mencakup serangkaian pasangan kata kunci/nilai yang dipisahkan oleh titik koma. Tanda sama dengan (=) menghubungkan setiap kata kunci dan nilainya. Untuk menyertakan nilai yang berisi titik koma, karakter tanda kutip tunggal, atau karakter tanda kutip ganda, nilai harus diapit dalam tanda kutip ganda. Jika nilai berisi titik koma dan karakter tanda kutip ganda, nilai dapat diapit dalam tanda kutip tunggal. Tanda kutip tunggal juga berguna jika nilai dimulai dengan karakter tanda kutip ganda. Sebaliknya, tanda kutip ganda dapat digunakan jika nilai dimulai dengan tanda kutip tunggal. Jika nilai berisi karakter tanda kutip tunggal dan tanda kutip ganda, karakter tanda kutip yang digunakan untuk mengapit nilai harus digandakan setiap kali terjadi dalam nilai.

Untuk menyertakan spasi sebelumnya atau berikutnya dalam nilai string, nilai harus diapit dalam tanda kutip tunggal atau tanda kutip ganda. Setiap spasi di depan atau di belakang di sekitar nilai bilangan bulat, Boolean, atau enumerasi diabaikan, bahkan jika diapit dalam tanda kutip. Namun, spasi dalam kata kunci atau nilai harfiah string dipertahankan. Tanda kutip tunggal atau ganda dapat digunakan dalam string koneksi tanpa menggunakan pemisah (misalnya, Sumber Data= my'Server atau Sumber Data= my"Server), kecuali karakter tanda kutip adalah karakter pertama atau terakhir dalam nilai.

Kata kunci tidak peka huruf besar/kecil.

Tabel berikut mencantumkan nama yang valid untuk nilai kata kunci dalam ConnectionString.

Keyword	Default	Description
Addr	N/A	Sinonim Sumber Data.
Alamat	N/A	Sinonim Sumber Data.
App	N/A	Sinonim Nama Aplikasi.
Niat Aplikasi -atau- ApplicationIntent	ReadWrite	Menyatakan jenis beban kerja aplikasi saat menyambungkan ke server. Nilai yang mungkin adalah ReadOnly dan ReadWrite. Contohnya: ApplicationIntent=ReadOnly Untuk informasi selengkapnya tentang dukungan SqlClient untuk Grup Ketersediaan AlwaysOn, lihat Dukungan SqlClient untuk Ketersediaan Tinggi, Pemulihan Bencana.
Nama Aplikasi	N/A	Nama aplikasi. Jika tidak ada nama aplikasi yang disediakan, 'Framework Microsoft SqlClient Data Provider' saat berjalan di .NET Framework dan 'Core Microsoft SqlClient Data Provider' sebaliknya. Nama aplikasi bisa 128 karakter atau kurang.
AttachDBFilename -atau- Properti yang Diperluas -atau- Nama File Awal	N/A	Nama file database utama, termasuk nama jalur lengkap database yang dapat dilampirkan. AttachDBFilename hanya didukung untuk file data utama dengan ekstensi .mdf. Jika nilai kunci AttachDBFileName ditentukan dalam string koneksi, database dilampirkan dan menjadi database default untuk koneksi. Jika kunci ini tidak ditentukan dan jika database sebelumnya dilampirkan, database tidak akan dipasang kembali. Database yang dilampirkan sebelumnya akan digunakan sebagai database default untuk koneksi. Jika kunci ini ditentukan bersama dengan kunci AttachDBFileName, nilai kunci ini akan digunakan sebagai alias. Namun, jika nama sudah digunakan dalam database terlampir lain, koneksi akan gagal. Jalur mungkin absolut atau relatif dengan menggunakan string substitusi DataDirectory. Jika DataDirectory digunakan, file database harus ada dalam subdirektori direktori yang diarahkan oleh string substitusi. Catatan: Nama jalur server jarak jauh, HTTP, dan UNC tidak didukung. Nama database harus ditentukan dengan kata kunci 'database' (atau salah satu aliasnya) seperti dalam hal berikut: "AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase" Kesalahan akan dihasilkan jika file log ada di direktori yang sama dengan file data dan kata kunci 'database' digunakan saat melampirkan file data utama. Dalam hal ini, hapus file log. Setelah database dilampirkan, file log baru akan dibuat secara otomatis berdasarkan jalur fisik.
Protokol Pengesahan	Tidak Ditentukan	Mendapatkan atau menetapkan nilai Protokol Pengesahan. Ketika tidak ada nilai yang ditentukan, enklave aman dinonaktifkan pada koneksi. Nilai yang valid adalah: AAS HGS None (Hanya berlaku di v3.1 dan v4.1+))
Authentication	N/A	Metode autentikasi yang digunakan untuk Koneksi ke SQL Database Dengan Menggunakan Autentikasi Entra ID. Nilai yang valid adalah: Direktori Aktif Integrated, Direktori Aktif Interactive, Direktori Aktif PasswordDirektori Aktif Service Principal, Direktori Aktif Device Code Flow, Direktori Aktif Managed Identity, Direktori Aktif MSI, Direktori Aktif Default, Sql Password. Untuk informasi tambahan, lihat Gunakan autentikasi Entra ID dengan SqlClient.
Pengaturan Enkripsi Kolom	dinonaktifkan	Mengaktifkan atau menonaktifkan fungsionalitas Always Encrypted untuk koneksi. Nilai yang didukung adalah: enabled dan disabled
Batas Waktu Perintah	30	Waktu tunggu default (dalam detik) sebelum mengakhiri upaya untuk menjalankan perintah dan menghasilkan kesalahan. Nilai yang valid lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 2147483647.
Jumlah Percobaan Ulang Koneksi -atau- ConnectRetryCount	1	Mengontrol jumlah upaya koneksi ulang setelah klien mengidentifikasi kegagalan koneksi diam. Nilai yang valid adalah 0 hingga 255. 0 berarti jangan mencoba menyambungkan kembali (nonaktifkan ketahanan koneksi). Catatan: Karena versi 5.x, nilai default untuk titik akhir non Azure adalah 1. Untuk titik akhir Azure SQL, defaultnya adalah 2. Untuk Azure SQL titik akhir tanpa server atau sesuai permintaan, defaultnya adalah 5 untuk meningkatkan keberhasilan koneksi untuk koneksi ke instans diam atau dijeda. Untuk informasi tambahan tentang ketahanan koneksi diam, lihat parameter .NET SqlConnection untuk coba lagi koneksi dan artikel Technical - Ketahanan Koneksi Menganggur.
Sambungkan Interval Coba Lagi -atau- ConnectRetryInterval	10	Menentukan waktu antara setiap upaya coba lagi koneksi (ConnectRetryCount). Nilai yang valid adalah 1 hingga 60 detik (default=10), diterapkan setelah upaya koneksi ulang pertama. Ketika koneksi yang rusak terdeteksi, klien segera mencoba untuk terhubung kembali; ini adalah upaya koneksi ulang pertama dan hanya terjadi jika ConnectRetryCount lebih besar dari 0. Jika upaya koneksi ulang pertama gagal dan ConnectRetryCount lebih besar dari 1, klien menunggu ConnectRetryInterval untuk mencoba upaya koneksi ulang kedua dan berikutnya. Untuk informasi tambahan tentang ketahanan koneksi diam, lihat parameter.NET SqlConnection untuk coba lagi koneksi dan artikel Technical - Ketahanan Koneksi Diam.
Waktu Habis Koneksi -atau- Waktu Tunggu Koneksi Habis -atau- Jeda Waktu	15	Lamanya waktu (dalam detik) untuk menunggu koneksi ke server sebelum mengakhiri upaya dan menghasilkan kesalahan. Nilai yang valid lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 2147483647. Saat membuka koneksi ke Azure SQL Database, atur batas waktu koneksi menjadi 30 detik.
Bahasa Saat Ini -atau- Bahasa	N/A	Mengatur bahasa yang digunakan untuk peringatan server database atau pesan kesalahan. Nama bahasa bisa 128 karakter atau kurang.
Sumber data -atau- Server -atau- Alamat -atau- Addr -atau- Alamat Jaringan	N/A	Nama atau alamat jaringan instans SQL Server yang akan disambungkan. Nomor port dapat ditentukan setelah nama server: server=tcp:servername, portnumber Saat menentukan instans lokal, selalu gunakan (lokal). Untuk memaksa protokol, tambahkan salah satu awalan berikut: np:(local), tcp:(local), lpc:(local) Anda juga dapat menyambungkan ke database LocalDB sebagai berikut: server=(localdb)\\myInstance Untuk informasi selengkapnya tentang LocalDB, lihat Dukungan SqlClient untuk LocalDB. Sumber Data harus menggunakan format TCP atau format Pipa Bernama. Format TCP adalah sebagai berikut: - tcp:<nama> host\<nama instans> - tcp:<nama host,> nomor< port TCP/IP> Format TCP harus dimulai dengan awalan "tcp:" dan diikuti oleh instans database, seperti yang ditentukan oleh nama host dan nama instans. Format ini tidak berlaku saat menyambungkan ke Azure SQL Database. TCP secara otomatis dipilih untuk koneksi ke Azure SQL Database saat tidak ada protokol yang ditentukan. Nama host HARUS ditentukan dengan salah satu cara berikut: - NetBIOSName - IPv4Address - IPv6Address Nama instans digunakan untuk mengatasi nomor port TCP/IP tertentu tempat instans database dihosting. Atau, menentukan nomor port TCP/IP secara langsung juga diizinkan. Jika nama instans dan nomor port tidak ada, instans database default akan digunakan. Format Named Pipes adalah sebagai berikut: - np:\\<host name>\pipe\<pipe name> Format Named Pipes HARUS dimulai dengan awalan "np:" dan diikuti dengan nama pipa bernama. Nama host HARUS ditentukan dengan salah satu cara berikut: - NetBIOSName - IPv4Address - IPv6Address Nama pipa digunakan untuk mengidentifikasi instans database tempat aplikasi .NET akan terhubung. Jika nilai kunci Jaringan ditentukan, awalan "tcp:" dan "np:" tidak boleh ditentukan. Catatan: Anda dapat memaksa penggunaan TCP alih-alih memori bersama, baik dengan awalan tcp: ke nama server dalam string koneksi, atau dengan menggunakan localhost.
Url Pengesahan Enklave	N/A	Mendapatkan atau mengatur URL pengesahan enklave yang akan digunakan dengan Always Encrypted berbasis enklave.
Enkripsi	'true' dalam 4.0 ke atas 'false' dalam 3.x ke bawah	Nilai yang dikenali adalah: versi 1 - 4: true/yes dan false/no versi 5+: truemandatory/yes/, falseno//optional dan .strict Ketika true, enkripsi TLS digunakan untuk semua data yang dikirim antara klien dan server jika server memiliki sertifikat yang diinstal. Ketika strict, enkripsi TDS 8.0 TLS digunakan dan TrustServerCertificate pengaturan diabaikan dan diperlakukan sebagai false. Untuk informasi selengkapnya, lihat Sintaks String Koneksi. Ketika Encryptmandatory atau strict dan TrustServerCertificatefalse, nama server (atau alamat IP) dalam sertifikat server harus sama persis dengan nama server (atau alamat IP) yang ditentukan dalam string koneksi. Jika tidak, upaya koneksi akan gagal.
Daftar enlist	'true'	true menunjukkan bahwa pengumpul koneksi SQL Server secara otomatis mendaftarkan koneksi dalam konteks transaksi saat ini utas pembuatan.
Mitra Failover	N/A	Nama server mitra failover tempat pencerminan database dikonfigurasi. Jika nilai kunci ini adalah "", maka Katalog Awal harus ada, dan nilainya tidak boleh "". Nama server bisa 128 karakter atau kurang. Jika Anda menentukan mitra failover tetapi server mitra failover tidak dikonfigurasi untuk pencerminan database dan server utama (ditentukan dengan kata kunci Server) tidak tersedia, maka koneksi akan gagal. Jika Anda menentukan mitra failover dan server utama tidak dikonfigurasi untuk pencerminan database, koneksi ke server utama (ditentukan dengan kata kunci Server) akan berhasil jika server utama tersedia.
SPN Mitra Failover -atau- FailoverPartnerSPN	N/A	SPN untuk mitra failover. Nilai default adalah string kosong, yang menyebabkan SqlClient menggunakan SPN default yang dihasilkan driver. (Hanya tersedia di v5.0+)
Nama host dalam sertifikat -atau- HostNameInCertificate	N/A	Nama host yang akan digunakan saat memvalidasi sertifikat server. Ketika tidak ditentukan, nama server dari Sumber Data digunakan untuk validasi sertifikat. (Hanya tersedia di v5.0+)
Sertifikat Server -atau- ServerCertificate	N/A	Jalur ke file sertifikat yang cocok dengan sertifikat TLS/SSL SQL Server. Format sertifikat yang diterima adalah PEM, DER, dan CER. Jika ditentukan, sertifikat SQL Server diperiksa dengan memverifikasi apakah ServerCertificate yang disediakan sama persis. (Hanya tersedia di v5.1+)
Katalog Awal -atau- Database	N/A	Nama database. Nama database bisa 128 karakter atau kurang.
Keamanan Terintegrasi -atau- Trusted_Connection	'false'	Ketika false, ID Pengguna dan Kata Sandi ditentukan dalam koneksi. Ketika true, kredensial akun Windows saat ini digunakan untuk autentikasi. Nilai yang dikenali adalah true, , falseyes, no, dan sspi (sangat disarankan), yang setara dengan true. Jika ID Pengguna dan Kata Sandi ditentukan dan Keamanan Terintegrasi diatur ke true, ID Pengguna dan Kata Sandi akan diabaikan dan Keamanan Terintegrasi akan digunakan. SqlCredential adalah cara yang lebih aman untuk menentukan kredensial untuk koneksi yang menggunakan Autentikasi SQL Server (Integrated Security=false).
Preferensi Alamat IP -atau- IPAddressPreference	IPv4First	Preferensi keluarga alamat IP saat membuat koneksi TCP. Jika Transparent Network IP Resolution (dalam .NET Framework) atau Multi Subnet Failover diatur ke true, pengaturan ini tidak berpengaruh. Nilai yang didukung meliputi: IPAddressPreference=IPv4First IPAddressPreference=IPv6First IPAddressPreference=UsePlatformDefault
Batas Waktu Keseimbangan Beban -atau- Masa Pakai Koneksi	0	Saat koneksi dikembalikan ke kumpulan, waktu pembuatannya dibandingkan dengan waktu saat ini, dan koneksi dimusnahkan jika rentang waktu tersebut (dalam detik) melebihi nilai yang ditentukan oleh Connection Lifetime. Ini berguna dalam konfigurasi berkluster untuk memaksa penyeimbangan beban antara server yang sedang berjalan dan server yang baru saja online. Nilai nol (0) menyebabkan koneksi terkumpul memiliki batas waktu koneksi maksimum.
Ukuran Kumpulan Maks	100	Jumlah maksimum koneksi yang diizinkan di kumpulan. Nilai yang valid lebih besar dari atau sama dengan 1. Nilai yang kurang dari Ukuran Kumpulan Min menghasilkan kesalahan.
Ukuran Kumpulan Min	0	Jumlah minimum koneksi yang diizinkan di kumpulan. Nilai yang valid lebih besar dari atau sama dengan 0. Nol (0) di bidang ini berarti tidak ada koneksi minimum yang awalnya dibuka. Nilai yang lebih besar dari Ukuran Kumpulan Maks menghasilkan kesalahan.
Beberapa Set Hasil Aktif -atau- MultipleActiveResultSets (beberapa set hasil aktif)	false	Ketika true, aplikasi dapat mempertahankan beberapa tataan hasil aktif (MARS). Ketika false, aplikasi harus memproses atau membatalkan semua kumpulan hasil dari satu batch sebelum dapat menjalankan batch lain pada koneksi tersebut. Nilai yang dikenali adalah true dan false. Untuk informasi selengkapnya, lihat Beberapa Kumpulan Hasil Aktif (MARS).
Multi Subnet Failover -atau- MultiSubnetFailover	false	Selalu tentukan multiSubnetFailover=True saat menyambungkan ke pendengar grup ketersediaan grup ketersediaan SQL Server 2012 (atau yang lebih baru) atau Instans Kluster Failover SQL Server 2012 (atau yang lebih baru). multiSubnetFailover=True mengonfigurasi SqlClient untuk memberikan deteksi dan koneksi yang lebih cepat ke server aktif (saat ini). Nilai yang mungkin adalah Yes dan No, True dan False atau 1 dan 0. Contohnya: MultiSubnetFailover=True Defaultnya adalah False. Untuk informasi selengkapnya tentang dukungan SqlClient untuk Always On AGs, lihat Dukungan SqlClient untuk Ketersediaan Tinggi, Pemulihan Bencana.
Pustaka Jaringan -atau- Network -atau- Jaringan	N/A	Pustaka jaringan yang digunakan untuk membuat koneksi ke instans SQL Server. Nilai yang didukung meliputi: dbnmpntw (Pipa Bernama) dbmsrpcn (Multiprotokol, Windows RPC) dbmsadsn (Apple Talk) dbmsgnet (VIA) dbmslpcn (Memori Bersama) dbmsspxn (IPX/SPX) dbmssocn (TCP/IP) Dbmsvinn (Banyan Vines) DLL jaringan yang sesuai harus diinstal pada sistem yang Anda sambungkan. Jika Anda tidak menentukan jaringan dan menggunakan server lokal (misalnya, "." atau "(lokal)"), memori bersama akan digunakan. Dalam contoh ini, pustaka jaringan adalah Win32 Winsock TCP/IP (dbmssocn), dan 1433 adalah port yang digunakan. Network Library=dbmssocn;Data Source=000.000.000.000,1433;
Ukuran Paket	delapan ribu	Ukuran dalam byte paket jaringan yang digunakan untuk berkomunikasi dengan instans SQL Server. Ukuran paket bisa lebih besar dari atau sama dengan 512 dan kurang dari atau sama dengan 32768.
Password -atau- PWD	N/A	Kata sandi untuk masuk akun SQL Server. Tidak disarankan. Untuk mempertahankan tingkat keamanan yang tinggi, kami sangat menyarankan Anda menggunakan kata kunci atau Integrated Security sebagai gantinyaTrusted_Connection. SqlCredential adalah cara yang lebih aman untuk menentukan kredensial untuk koneksi yang menggunakan Autentikasi SQL Server. Kata sandi harus 128 karakter atau kurang.
Simpan Informasi Keamanan -atau- PersistSecurityInfo	'false'	Ketika diatur ke false atau no (sangat disarankan), informasi sensitif keamanan, seperti kata sandi atau token akses, tidak dikembalikan sebagai bagian dari koneksi jika koneksi terbuka atau pernah dalam status terbuka. Properti ini hanya boleh diatur ke true jika aplikasi Anda memiliki kebutuhan khusus untuk membaca kata sandi dari koneksi database yang sudah dibuka. Nilai default adalah pengaturan yang lebih aman; menggunakan true untuk properti ini membuka aplikasi Anda terhadap risiko keamanan seperti pengelogan false atau pelacakan kata sandi database secara tidak sengaja. Mengatur ulang string koneksi mengatur ulang semua nilai string koneksi termasuk kata sandi. Nilai yang dikenali adalah true, , falseyes, dan no.
Periode Pemblokiran Pool -atau- PeriodePemblokiranPool	Auto	Mengatur perilaku periode pemblokiran untuk kumpulan koneksi. Lihat PoolBlockingPeriod properti untuk detailnya.
Penggabungan	'true'	Ketika nilai kunci ini diatur ke true, koneksi yang baru dibuat akan ditambahkan ke kumpulan ketika ditutup oleh aplikasi. Dalam upaya berikutnya untuk membuka koneksi yang sama, koneksi tersebut akan diambil dari kumpulan. Koneksi dianggap sama jika memiliki string koneksi yang sama. Koneksi yang berbeda memiliki string koneksi yang berbeda. Nilai kunci ini bisa menjadi "true", "false", "yes", atau "no".
Replication	'false'	true jika replikasi didukung menggunakan koneksi.
Server SPN -atau- ServerSPN	N/A	SPN untuk sumber data. Nilai default adalah string kosong, yang menyebabkan SqlClient menggunakan SPN default yang dihasilkan driver. (Hanya tersedia di v5.0+)
Pengikatan Transaksi	Pelepasan Implisit	Mengontrol asosiasi koneksi dengan transaksi yang terdaftar System.Transactions . Nilai yang mungkin adalah: Transaction Binding=Implicit Unbind; Transaction Binding=Explicit Unbind; Implisit Unbind menyebabkan koneksi terlepas dari transaksi ketika berakhir. Setelah mencopot, permintaan tambahan pada koneksi dilakukan dalam mode autocommit. Properti System.Transactions.Transaction.Current tidak diperiksa saat menjalankan permintaan saat transaksi aktif. Setelah transaksi berakhir, permintaan tambahan dilakukan dalam mode autocommit. Jika sistem mengakhiri transaksi (dalam cakupan blok penggunaan) sebelum perintah terakhir selesai, itu akan melemparkan InvalidOperationException. Unbind Eksplisit menyebabkan koneksi tetap terlampir pada transaksi hingga koneksi ditutup atau eksplisit SqlConnection.TransactionEnlist(null) dipanggil. Dimulai di .NET Framework 4.0, perubahan pada Implisit Unbind membuat Explicit Unbind kedaluwarsa. Dilemparkan InvalidOperationException jika Transaction.Current bukan transaksi terdaftar atau jika transaksi terdaftar tidak aktif.
Resolusi IP Jaringan Transparan -atau- Resolusi IP Jaringan Transparan	Lihat deskripsi.	Ketika nilai kunci ini diatur ke true, aplikasi diperlukan untuk mengambil semua alamat IP untuk entri DNS tertentu dan mencoba terhubung dengan yang pertama dalam daftar. Jika koneksi tidak dibuat dalam waktu 0,5 detik, aplikasi akan mencoba menyambungkan ke semua yang lain secara paralel. Ketika jawaban pertama, aplikasi akan membuat koneksi dengan alamat IP responden. Jika kunci MultiSubnetFailover diatur ke true, TransparentNetworkIPResolution diabaikan. Jika kunci Failover Partner diatur, TransparentNetworkIPResolution diabaikan. Nilai kunci ini harus true, , false, yesatau no. Nilai yes diperlakukan sama dengan nilai true. Nilai no diperlakukan sama dengan nilai false. Nilai default adalah sebagai berikut: false Kapan: Menyambungkan ke Azure SQL Database tempat sumber data berakhir dengan: .database.chinacloudapi.cn .database.usgovcloudapi.net .database.cloudapi.de .database.windows.net .database.fabric.microsoft.com Authentication adalah 'Kata Sandi Direktori Aktif' atau 'Direktori Aktif Terintegrasi' true dalam semua kasus lainnya.
Sertifikat Server Kepercayaan -atau- TrustServerCertificate	'false'	Ketika diatur ke true, TLS digunakan untuk mengenkripsi saluran saat melewati rantai sertifikat untuk memvalidasi kepercayaan. Jika TrustServerCertificate diatur ke true dan Enkripsi diatur ke false, saluran tidak dienkripsi. Nilai yang dikenali adalah true, , falseyes, dan no. Untuk informasi selengkapnya, lihat Sintaks String Koneksi.
Ketik Versi Sistem	N/A	Nilai string yang menunjukkan sistem jenis yang diharapkan aplikasi. Fungsionalitas yang tersedia untuk aplikasi klien tergantung pada versi SQL Server dan tingkat kompatibilitas database. Secara eksplisit mengatur versi sistem jenis yang ditulis aplikasi klien untuk menghindari potensi masalah yang dapat menyebabkan aplikasi rusak jika versi SQL Server yang berbeda digunakan. Catatan: Versi sistem jenis tidak dapat diatur untuk kode runtime bahasa umum (CLR) yang dijalankan dalam proses di SQL Server. Untuk informasi selengkapnya, lihat Integrasi Runtime Bahasa Umum SQL Server. Nilai yang mungkin adalah: Type System Version=SQL Server 2012; Type System Version=SQL Server 2008; Type System Version=SQL Server 2005; Type System Version=Latest; Type System Version=SQL Server 2012; menentukan bahwa aplikasi akan memerlukan Microsoft.SqlServer.Types.dllversi 11.0.0.0 . Pengaturan lainnya Type System Version akan memerlukan Microsoft.SqlServer.Types.dllversi 10.0.0.0. Latest sudah kedaluwarsa dan tidak boleh digunakan. Latest setara dengan Type System Version=SQL Server 2008;.
ID Pengguna -atau- UID -atau- Pengguna	N/A	Akun masuk SQL Server. Tidak disarankan. Untuk mempertahankan tingkat keamanan yang tinggi, kami sangat menyarankan Anda menggunakan kata kunci atau Integrated Security sebagai gantinyaTrusted_Connection. SqlCredential adalah cara yang lebih aman untuk menentukan kredensial untuk koneksi yang menggunakan Autentikasi SQL Server. ID pengguna harus 128 karakter atau kurang.
Instans Pengguna	'false'	Nilai yang menunjukkan apakah akan mengalihkan koneksi dari instans SQL Server Express default ke instans yang dimulai runtime yang berjalan di bawah akun pemanggil.
ID Stasiun Kerja -atau- WSID	Nama komputer lokal	Nama stasiun kerja yang tersambung ke SQL Server. ID harus 128 karakter atau kurang.

Daftar berikut berisi nama yang valid untuk nilai pengumpulan koneksi dalam ConnectionString. Untuk informasi selengkapnya, lihat SQL Server Connection Pooling (ADO.NET).

• Masa Pakai Koneksi (atau Batas Waktu Keseimbangan Beban)

• Daftar enlist

• Ukuran Kumpulan Maks

• Ukuran Kumpulan Min

• Penggabungan

Saat Anda mengatur kata kunci atau nilai pengumpulan koneksi yang memerlukan nilai Boolean, Anda dapat menggunakan 'ya' alih-alih 'true', dan 'tidak' alih-alih 'false'. Nilai bilangan bulat direpresentasikan sebagai string.

Nota

Penyedia Data .NET Framework untuk SQL Server menggunakan protokolnya sendiri untuk berkomunikasi dengan SQL Server. Oleh karena itu, ia tidak mendukung penggunaan nama sumber data ODBC (DSN) saat menyambungkan ke SQL Server karena tidak menambahkan lapisan ODBC.

Nota

File tautan data universal (UDL) tidak didukung untuk Penyedia Data .NET Framework untuk SQL Server.

Caution

Dalam rilis ini, aplikasi harus berhati-hati saat membuat string koneksi berdasarkan input pengguna (misalnya saat mengambil ID pengguna dan informasi kata sandi dari kotak dialog, dan menambahkannya ke string koneksi). Aplikasi harus memastikan bahwa pengguna tidak dapat menyematkan parameter string koneksi tambahan dalam nilai-nilai ini (misalnya, memasukkan kata sandi sebagai "validpassword; database=somedb" dalam upaya untuk melampirkan ke database yang berbeda). Jika Anda perlu membuat string koneksi berdasarkan input pengguna, gunakan SqlConnectionStringBuilder baru, yang memvalidasi string koneksi dan membantu menghilangkan masalah ini. Lihat Penyusun String Koneksi untuk informasi selengkapnya.