Bagikan melalui


SqlConnection.ConnectionString Properti

Definisi

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); };
public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public override string ConnectionString { get; set; }
[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
public string ConnectionString { get; set; }
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
[<System.Data.DataSysDescription("SqlConnection_ConnectionString")>]
member this.ConnectionString : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set
Public Overrides Property ConnectionString As String
Public Property ConnectionString As String

Nilai Properti

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

Penerapan

Atribut

Pengecualian

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.

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;";
}
Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection()

        connection.ConnectionString = connectionString

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

Keterangan

ConnectionString mirip dengan string koneksi OLE DB, tetapi tidak identik. Tidak seperti OLE DB atau ADO, string koneksi yang dikembalikan sama dengan informasi keamanan , minus yang ditetapkan ConnectionStringpengguna jika nilai Persist Security Info 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 durasi. Untuk informasi selengkapnya, lihat Pembuat String Koneksi.

ConnectionString Properti hanya dapat diatur ketika koneksi ditutup. Banyak nilai string koneksi memiliki properti baca-saja yang sesuai. Ketika 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 ulang ConnectionString 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 ditetapkan. 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 menyertakan 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 di belakang 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 ini mencantumkan nama yang valid untuk nilai kata kunci dalam ConnectionString.

Kata kunci Default Deskripsi
Addr T/A Sinonim Sumber Data.
Alamat T/A Sinonim Sumber Data.
Aplikasi T/A Sinonim Nama Aplikasi.
Nama Aplikasi T/A Nama aplikasi, atau '.NET SQLClient Data Provider' jika tidak ada nama aplikasi yang disediakan.

Nama aplikasi bisa 128 karakter atau kurang.
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.
Pemrosesan Asinkron

-atau-

Asinkron
'false' Ketika true, mengaktifkan dukungan operasi asinkron. Nilai yang dikenali adalah true, false, yes, dan no.

Properti ini diabaikan dimulai pada .NET Framework 4.5. Untuk informasi selengkapnya tentang dukungan SqlClient untuk pemrograman asinkron, lihat Pemrograman Asinkron.
AttachDBFilename

-atau-

Properti yang Diperluas

-atau-

Nama File Awal
T/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=&#124;DataDirectory&#124;\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.
Autentikasi T/A Metode autentikasi yang digunakan untuk Menyambungkan ke SQL Database Dengan Menggunakan Autentikasi Azure Active Directory.

Nilai yang valid adalah:

Active Directory Terintegrasi, Kata Sandi Direktori Aktif, Kata Sandi Sql.
Pengaturan Enkripsi Kolom T/A Mengaktifkan atau menonaktifkan fungsionalitas Always Encrypted untuk koneksi.
Batas Waktu Sambungkan

-atau-

Waktu Tunggu Koneksi Habis

-atau-

Batas 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 database Azure SQL, atur batas waktu koneksi menjadi 30 detik.
Masa Pakai Koneksi

-atau-

Batas Waktu Keseimbangan Beban
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.
ConnectRetryCount 1 Mengontrol jumlah upaya koneksi ulang setelah klien mengidentifikasi kegagalan koneksi diam. Nilai yang valid adalah 0 hingga 255. Defaultnya adalah 1. 0 berarti jangan mencoba menyambungkan kembali (menonaktifkan ketahanan koneksi).

Untuk informasi tambahan tentang ketahanan koneksi, lihat parameter .NET SqlConnection untuk coba lagi koneksi dan Artikel Teknis - Ketahanan Koneksi Menganggur.
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, lihat parameter .NET SqlConnection untuk coba lagi koneksi dan Artikel Teknis - Ketahanan Koneksi Menganggur.
Koneksi Konteks 'false' truejika koneksi dalam proses ke SQL Server harus dibuat.
Bahasa Saat Ini

-atau-

Bahasa
T/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
T/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)

Mulai dari .NET Framework 4.5, Anda juga bisa 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 Named Pipes.

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 database Azure SQL. TCP secara otomatis dipilih untuk koneksi ke Azure SQL Database ketika 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:\\<nama host>\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 Framework 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 mengawali tcp: ke nama server di string koneksi, atau dengan menggunakan localhost.
Encrypt 'false' Ketika true, SQL Server menggunakan enkripsi SSL untuk semua data yang dikirim antara klien dan server jika server memiliki sertifikat yang diinstal. Nilai yang dikenali adalah true, false, yes, dan no. Untuk informasi selengkapnya, lihat Sintaks String Koneksi.

Mulai dari .NET Framework 4.5, ketika TrustServerCertificate salah dan Encrypt benar, nama server (atau alamat IP) dalam sertifikat SSL SQL Server harus sama persis dengan nama server (atau alamat IP) yang ditentukan dalam string koneksi. Jika tidak, upaya koneksi akan gagal.
Daftar 'true' truemenunjukkan bahwa pengumpul koneksi SQL Server secara otomatis mendaftarkan koneksi dalam konteks transaksi alur pembuatan saat ini.
Mitra Failover T/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.
Katalog Awal

-atau-

Database
T/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.

SqlCredentialadalah cara yang lebih aman untuk menentukan kredensial untuk koneksi yang menggunakan Autentikasi SQL Server (Integrated Security=false).
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.
MultipleActiveResultSets 'false' Ketika true, aplikasi dapat mempertahankan beberapa tataan hasil aktif (MARS). Ketika false, aplikasi harus memproses atau membatalkan semua tataan 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).
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

Default adalah False. Untuk informasi selengkapnya tentang dukungan SqlClient untuk Always On AGs, lihat Dukungan SqlClient untuk Ketersediaan Tinggi, Pemulihan Bencana.
Pustaka Jaringan

-atau-

Jaringan

-atau-

Bersih
T/A Pustaka jaringan yang digunakan untuk membuat koneksi ke instans SQL Server. Nilai yang didukung mencakup:

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 8000 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.
Kata sandi

-atau-

PWD
T/A Kata sandi untuk masuk akun SQL Server. Tidak direkomendasikan. Untuk mempertahankan tingkat keamanan yang tinggi, kami sangat menyarankan Anda menggunakan kata kunci atau Trusted_Connection sebagai gantinyaIntegrated Security. SqlCredentialadalah cara yang lebih aman untuk menentukan kredensial untuk koneksi yang menggunakan Autentikasi SQL Server.

Kata sandi harus 128 karakter atau kurang.
Pertahankan Info Keamanan

-atau-

PersistSecurityInfo
'false' Ketika diatur ke false atau no (sangat disarankan), informasi sensitif keamanan, seperti kata sandi, tidak dikembalikan sebagai bagian dari koneksi jika koneksi terbuka atau pernah dalam keadaan terbuka. Mengatur ulang string koneksi mengatur ulang semua nilai string koneksi termasuk kata sandi. Nilai yang dikenali adalah true, false, yes, dan no.
PoolBlockingPeriod Otomatis 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.

Connections dianggap sama jika mereka memiliki string koneksi yang sama. Koneksi yang berbeda memiliki string koneksi yang berbeda.

Nilai kunci ini dapat berupa "true", "false", "yes", atau "no".
Replikasi 'false' true jika replikasi didukung menggunakan koneksi.
Pengikatan Transaksi Terikat secara implisit Mengontrol asosiasi koneksi dengan transaksi yang terdaftar System.Transactions .

Potensi nilai:

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. Mulai dari .NET Framework 4, perubahan pada Implisit Unbind membuat Explicit Unbind kedaluwarsa. InvalidOperationException dilemparkan jika Transaction.Current bukan transaksi terdaftar atau jika transaksi terdaftar tidak aktif.
TransparentNetworkIPResolution Lihat deskripsi. Ketika nilai kunci ini diatur ke true, aplikasi diperlukan untuk mengambil semua alamat IP untuk entri DNS tertentu dan mencoba untuk terhubung dengan yang pertama dalam daftar. Jika koneksi tidak dibuat dalam waktu 0,5 detik, aplikasi akan mencoba terhubung ke semua orang lain secara paralel. Ketika jawaban pertama, aplikasi akan membangun koneksi dengan alamat IP responden.

Jika kunci MultiSubnetFailover diatur ke true, TransparentNetworkIPResolution diabaikan.

Failover Partner Jika kunci diatur, TransparentNetworkIPResolution diabaikan.

Nilai kunci ini harus true, , falseyes, atau no.

Nilai yes diperlakukan sama dengan nilai true.

Nilai no diperlakukan sama dengan nilai false.

Nilai defaultnya adalah sebagai berikut:

  • false Kapan:

    • Menyambungkan ke Azure SQL Database tempat sumber data diakhir dengan:

      • .database.chinacloudapi.cn
      • .database.usgovcloudapi.net
      • .database.cloudapi.de
      • .database.windows.net
    • Authentication adalah 'Kata Sandi Direktori Aktif' atau 'Active Directory Terintegrasi'
  • true dalam semua kasus lain.
TrustServerCertificate 'false' Ketika diatur ke true, SSL 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, false, yes, dan no. Untuk informasi selengkapnya, lihat Sintaks String Koneksi.
Ketik Versi Sistem T/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 menjalankan dalam proses dalam SQL Server. Untuk informasi selengkapnya, lihat SQL Server Integrasi Runtime Bahasa Umum.

Potensi nilai:

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.dll versi 11.0.0.0. Pengaturan lainnya Type System Version akan memerlukan Microsoft.SqlServer.Types.dll versi 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
T/A Akun masuk SQL Server. Tidak direkomendasikan. Untuk menjaga tingkat keamanan yang tinggi, kami sangat menyarankan Anda menggunakan kata kunci atau Trusted_Connection sebagai gantinyaIntegrated Security. SqlCredentialadalah 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 Kumpulan Koneksi SQL Server (ADO.NET).

  • Masa Pakai Koneksi (atau Batas Waktu Keseimbangan Beban)

  • Daftar

  • 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.

Catatan

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.

Catatan

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

Perhatian

Dalam rilis ini, aplikasi harus berhati-hati saat membuat string koneksi berdasarkan input pengguna (misalnya saat mengambil INFORMASI ID pengguna dan 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 yang baru SqlConnectionStringBuilder, yang memvalidasi string koneksi dan membantu menghilangkan masalah ini. Lihat Penyusun String Koneksi untuk informasi selengkapnya.

Berlaku untuk

Lihat juga