SqlConnection.ConnectionString Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
SQL Server veritabanını açmak için kullanılan dizeyi alır veya ayarlar.
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
Özellik Değeri
Kaynak veritabanı adını içeren bağlantı dizesi ve ilk bağlantıyı kurmak için gereken diğer parametreler. Varsayılan değer boş bir dizedir.
Uygulamalar
- Öznitelikler
Özel durumlar
Geçersiz bir bağlantı dizesi bağımsız değişkeni sağlandı veya gerekli bir bağlantı dizesi bağımsız değişkeni sağlanmadı.
Örnekler
Aşağıdaki örnek bir SqlConnection oluşturur ve bağlantıyı açmadan önce özelliğini ayarlar ConnectionString .
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
Açıklamalar
ConnectionString bir OLE DB bağlantı dizesine benzer, ancak aynı değildir. OLE DB veya ADO'nın aksine, döndürülen bağlantı dizesi, Güvenlik Bilgilerini Kalıcı Hale Getirmek için (varsayılan) olarak ayarlanmışsa false , kullanıcı kümesi ConnectionString, eksi güvenlik bilgileri ile aynıdır. SQL Server için .NET Framework Veri Sağlayıcısı, Güvenlik Bilgilerini trueKalıcı Hale Getir olarak ayarlamadığınız sürece bir bağlantı dizesinde parolayı kalıcı yapmaz veya döndürmez.
bir veritabanına bağlanmak için özelliğini kullanabilirsiniz ConnectionString . Aşağıdaki örnekte tipik bir bağlantı dizesi gösterilmektedir.
"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"
Çalışma zamanında geçerli bağlantı dizeleri oluşturmak için yeniyi SqlConnectionStringBuilder kullanın. Daha fazla bilgi için bkz . Bağlantı Dizesi Oluşturucuları.
ConnectionString Özelliği yalnızca bağlantı kapatıldığında ayarlanabilir. Bağlantı dizesi değerlerinin çoğunun karşılık gelen salt okunur özellikleri vardır. Bağlantı dizesi ayarlandığında, bir hata algılandığı durumlar dışında bu özellikler güncelleştirilir. Bu durumda, özelliklerin hiçbiri güncelleştirilmez. SqlConnection özellikleri yalnızca içinde ConnectionStringbulunan ayarları döndürür.
Yerel bilgisayara bağlanmak için sunucu için "(yerel)" belirtin. Sunucu adı belirtilmezse, yerel bilgisayardaki varsayılan örneğe bağlantı denenecektir.
kapalı bir bağlantının ConnectionString sıfırlanması, parola da dahil olmak üzere tüm bağlantı dizesi değerlerini (ve ilgili özellikleri) sıfırlar. Örneğin, "Database= AdventureWorks" içeren bir bağlantı dizesi ayarlar ve ardından bağlantı dizesini "Data Source=myserver" olarak sıfırlarsanız; Integrated Security=true", Database özelliği artık "AdventureWorks" olarak ayarlanmadı.
Bağlantı dizesi ayarlandıktan hemen sonra ayrıştırılır. Ayrıştırma sırasında söz diziminde hatalar bulunursa, gibi ArgumentExceptionbir çalışma zamanı özel durumu oluşturulur. Diğer hatalar yalnızca bağlantıyı açma girişiminde bulunulduğunda bulunabilir.
Bağlantı dizesinin temel biçimi, noktalı virgülle ayrılmış bir dizi anahtar sözcük/değer çifti içerir. eşittir işareti (=) her anahtar sözcüğü ve değerini bağlar. Noktalı virgül, tek tırnak karakteri veya çift tırnak karakteri içeren değerleri eklemek için, değerin çift tırnak içine alınması gerekir. Değer hem noktalı virgül hem de çift tırnak karakteri içeriyorsa, değer tek tırnak içine alınabilir. Değer çift tırnak karakteriyle başlıyorsa tek tırnak işareti de yararlıdır. Buna karşılık, değer tek bir tırnak işaretiyle başlıyorsa çift tırnak işareti kullanılabilir. Değer hem tek tırnaklı hem de çift tırnak karakterleri içeriyorsa, değerin içine almak için kullanılan tırnak işareti karakteri, değer içinde her oluştuğunda iki katına çıkarılmalıdır.
Dize değerine önceki veya sondaki boşlukları eklemek için, değerin tek tırnak işareti veya çift tırnak içine alınması gerekir. Tamsayı, Boole veya numaralandırılmış değerlerin etrafındaki baştaki veya sondaki boşluklar tırnak içine alınmış olsa bile yoksayılır. Ancak, bir dize değişmez anahtar sözcüğü veya değeri içindeki boşluklar korunur. Bir tırnak işareti karakteri değerdeki ilk veya son karakter olmadığı sürece, bağlantı dizesinde sınırlayıcılar kullanılmadan tek veya çift tırnak işaretleri kullanılabilir (örneğin, Veri Kaynağı= my'Server veya Veri Kaynağı= my"Server).
Anahtar sözcükler büyük/küçük harfe duyarlı değildir.
Aşağıdaki tabloda içindeki anahtar sözcük değerleri için geçerli adlar listelemektedir ConnectionString.
| Anahtar sözcük | Varsayılan | Açıklama |
|---|---|---|
Addr |
N/A | Veri Kaynağının Eş Anlamlısı. |
Address |
N/A | Veri Kaynağının Eş Anlamlısı. |
App |
N/A | Uygulama Adı eş anlamlısı. |
Application Name |
N/A | Uygulama adı sağlanmadıysa uygulamanın adı veya '.NET SQLClient Veri Sağlayıcısı'. Uygulama adı 128 karakter veya daha kısa olabilir. |
ApplicationIntent |
ReadWrite |
Sunucuya bağlanırken uygulama iş yükü türünü bildirir. Olası değerler ReadOnly ve ReadWrite şeklindedir. Örneğin:ApplicationIntent=ReadOnlyAlways On Kullanılabilirlik Grupları için SqlClient desteği hakkında daha fazla bilgi için bkz. Yüksek Kullanılabilirlik için SqlClient Desteği, Olağanüstü Durum Kurtarma. |
Asynchronous Processing-veya- Async |
'false' | olduğunda true, zaman uyumsuz işlem desteğini etkinleştirir. Tanınan değerler , true, falseve yesdeğerleridirno.Bu özellik .NET Framework 4.5'te başlayarak yoksayılır. Zaman uyumsuz programlama için SqlClient desteği hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama. |
AttachDBFilename-veya- Extended Properties-veya- Initial File Name |
N/A | Eklenebilir veritabanının tam yol adı da dahil olmak üzere birincil veritabanı dosyasının adı. AttachDBFilename yalnızca .mdf uzantısına sahip birincil veri dosyaları için desteklenir. Bağlantı dizesinde AttachDBFileName anahtarının değeri belirtilirse, veritabanı eklenir ve bağlantı için varsayılan veritabanı olur. Bu anahtar belirtilmezse ve veritabanı daha önce eklenmişse, veritabanı yeniden eklenmez. Önceden eklenen veritabanı, bağlantı için varsayılan veritabanı olarak kullanılacaktır. Bu anahtar AttachDBFileName anahtarıyla birlikte belirtilirse, bu anahtarın değeri diğer ad olarak kullanılır. Ancak, ad başka bir ekli veritabanında zaten kullanılıyorsa, bağlantı başarısız olur. DataDirectory değiştirme dizesini kullanarak yol mutlak veya göreli olabilir. DataDirectory kullanılırsa, veritabanı dosyası değiştirme dizesi tarafından işaret edilen dizinin bir alt dizininde bulunmalıdır. Not: Uzak sunucu, HTTP ve UNC yol adları desteklenmez. Veritabanı adı aşağıdaki gibi 'database' (veya diğer adlarından biri) anahtar sözcüğüyle belirtilmelidir: "AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase"Veri dosyasıyla aynı dizinde bir günlük dosyası varsa ve birincil veri dosyası eklenirken 'database' anahtar sözcüğü kullanılıyorsa bir hata oluşturulur. Bu durumda günlük dosyasını kaldırın. Veritabanı eklendikten sonra, fiziksel yola göre otomatik olarak yeni bir günlük dosyası oluşturulur. |
Authentication |
N/A |
Azure Active Directory Kimlik Doğrulaması Kullanarak SQL Veritabanına Bağlanma için kullanılan kimlik doğrulama yöntemi. Geçerli değerler şunlardır: Active Directory Tümleşik, Active Directory Parolası, Sql Parolası. |
Column Encryption Setting |
N/A | Bağlantı için Always Encrypted işlevselliğini etkinleştirir veya devre dışı bırakır. |
Connect Timeout-veya- Connection Timeout-veya- Timeout |
15 | Denemeyi sonlandırmadan ve hata oluşturmadan önce sunucu bağlantısını bekleme süresi (saniye cinsinden). Geçerli değerler 0'a eşit veya 0'a eşit ve 2147483647'a eşit veya ondan küçüktür. Azure SQL Veritabanı'na bağlantı açarken bağlantı zaman aşımını 30 saniye olarak ayarlayın. |
Connection Lifetime-veya- Load Balance Timeout |
0 | Havuza bir bağlantı döndürülürse, oluşturma süresi geçerli saatle karşılaştırılır ve bu zaman aralığı (saniye cinsinden) tarafından Connection Lifetimebelirtilen değeri aşarsa bağlantı yok edilir. Bu, kümelenmiş yapılandırmalarda çalışan bir sunucu ile yeni çevrimiçi duruma getirilmiş bir sunucu arasında yük dengelemeye zorlamak için kullanışlıdır.Sıfır (0) değeri, havuza alınan bağlantıların en fazla bağlantı zaman aşımına sahip olmasına neden olur. |
ConnectRetryCount |
1 | İstemci boşta bağlantı hatası tanımladıktan sonra yeniden bağlanma denemelerinin sayısını denetler. Geçerli değerler 0 ile 255'tir. Varsayılan değer 1'dir. 0, yeniden bağlanmaya çalışmama (bağlantı dayanıklılığını devre dışı bırakma) anlamına gelir. Bağlantı dayanıklılığı hakkında ek bilgi için bkz. Bağlantı yeniden denemesi için .NET SqlConnection parametreleri ve Teknik Makale - Boşta Bağlantı Dayanıklılığı. |
ConnectRetryInterval |
10 | Her bağlantı yeniden deneme girişimi (ConnectRetryCount) arasındaki süreyi belirtir. Geçerli değerler, ilk yeniden bağlanma girişiminden sonra uygulanan 1 ile 60 saniye (default=10) arasındadır. Kopuk bir bağlantı algılandığında, istemci hemen yeniden bağlanmayı dener; bu ilk yeniden bağlanma girişimidir ve yalnızca ConnectRetryCount değeri 0'dan büyükse gerçekleşir. İlk yeniden bağlanma girişimi başarısız olursa ve ConnectRetryCount 1'den büyükse, istemci ikinci ve sonraki yeniden bağlanma girişimlerini denemek için ConnectRetryInterval'ı bekler. Bağlantı dayanıklılığı hakkında ek bilgi için bkz. Bağlantı yeniden denemesi için .NET SqlConnection parametreleri ve Teknik Makale - Boşta Bağlantı Dayanıklılığı. |
Context Connection |
'false' |
true SQL Server'a işlem içi bir bağlantı yapılması gerekiyorsa. |
Current Language-veya- Language |
N/A | Veritabanı sunucusu uyarısı veya hata iletileri için kullanılan dili ayarlar. Dil adı 128 karakter veya daha kısa olabilir. |
Data Source-veya- Server-veya- Address-veya- Addr-veya- Network Address |
N/A | Bağlanacak SQL Server örneğinin adı veya ağ adresi. Bağlantı noktası numarası sunucu adından sonra belirtilebilir:server=tcp:servername, portnumberYerel bir örnek belirtirken her zaman (yerel) kullanın. Bir protokolü zorlamak için aşağıdaki ön eklerden birini ekleyin: np:(local), tcp:(local), lpc:(local).NET Framework 4.5'den başlayarak, aşağıdaki gibi bir LocalDB veritabanına da bağlanabilirsiniz: server=(localdb)\\myInstanceLocalDB hakkında daha fazla bilgi için bkz. LocalDB için SqlClient Desteği. Veri Kaynağı TCP biçimini veya Adlandırılmış Kanallar biçimini kullanmalıdır. TCP biçimi aşağıdaki gibidir: - tcp:<konak adı>\<örnek adı> - tcp:<konak adı,TCP></IP bağlantı noktası numarası> TCP biçimi "tcp:" ön eki ile başlamalıdır ve ardından bir konak adı ve örnek adı tarafından belirtilen veritabanı örneği gelir. Bu biçim, Azure SQL Veritabanı'na bağlanırken geçerli değildir. Protokol belirtilmediğinde Azure SQL Veritabanı bağlantıları için TCP otomatik olarak seçilir. Konak adı aşağıdaki yollardan biriyle belirtilmelidir: - NetBIOSName - IPv4Address - IPv6Address Örnek adı, veritabanı örneğinin barındırıldığı belirli bir TCP/IP bağlantı noktası numarasına çözümlemek için kullanılır. Alternatif olarak, doğrudan bir TCP/IP bağlantı noktası numarası belirtmeye de izin verilir. Hem örnek adı hem de bağlantı noktası numarası yoksa, varsayılan veritabanı örneği kullanılır. Adlandırılmış Kanallar biçimi aşağıdaki gibidir: - np:\\<konak adı>\pipe\<pipe name> Adlandırılmış Kanallar biçimi "np:" ön eki ile başlamalıdır ve ardından adlandırılmış kanal adı gelir. Konak adı aşağıdaki yollardan biriyle belirtilmelidir: - NetBIOSName - IPv4Address - IPv6Address Kanal adı, .NET Framework uygulamasının bağlanacağı veritabanı örneğini tanımlamak için kullanılır. Ağ anahtarının değeri belirtilirse, "tcp:" ve "np:" ön ekleri belirtilmemelidir. Not: Tcp: ön ekini bağlantı dizesindeki sunucu adına ekleyerek veya localhost kullanarak paylaşılan bellek yerine TCP kullanımını zorlayabilirsiniz. |
Encrypt |
'false' | olduğunda true, sunucuda yüklü bir sertifika varsa, SQL Server istemci ile sunucu arasında gönderilen tüm veriler için SSL şifrelemesi kullanır. Tanınan değerler , true, falseve yesdeğerleridirno. Daha fazla bilgi için bkz. Bağlantı Dizesi Sözdizimi..NET Framework 4.5 sürümünden başlayarak, false ve Encrypt true olduğundaTrustServerCertificate, SQL Server SSL sertifikasındaki sunucu adı (veya IP adresi), bağlantı dizesinde belirtilen sunucu adıyla (veya IP adresiyle) tam olarak eşleşmelidir. Aksi takdirde bağlantı girişimi başarısız olur. |
Enlist |
'true' |
true SQL Server bağlantı havuzu oluşturucusunun bağlantıyı otomatik olarak oluşturma iş parçacığının geçerli işlem bağlamında listelediğini gösterir. |
Failover Partner |
N/A | Veritabanı yansıtmanın yapılandırıldığı yük devretme iş ortağı sunucusunun adı. Bu anahtarın değeri "" ise, İlk Katalog mevcut olmalı ve değeri "" olmamalıdır. Sunucu adı 128 karakter veya daha kısa olabilir. Bir yük devretme iş ortağı belirtirseniz ancak yük devretme iş ortağı sunucusu veritabanı yansıtması için yapılandırılmamışsa ve birincil sunucu (Sunucu anahtar sözcüğüyle belirtilir) kullanılamıyorsa, bağlantı başarısız olur. Bir yük devretme iş ortağı belirtirseniz ve birincil sunucu veritabanı yansıtması için yapılandırılmamışsa, birincil sunucu kullanılabilir durumdaysa birincil sunucu bağlantısı (Sunucu anahtar sözcüğüyle belirtilir) başarılı olur. |
Initial Catalog-veya- Database |
N/A | Veritabanının adı. Veritabanı adı 128 karakter veya daha kısa olabilir. |
Integrated Security-veya- Trusted_Connection |
'false' | Bağlantıda false, Kullanıcı Kimliği ve Parola belirtildiğinde. olduğunda true, geçerli Windows hesabı kimlik bilgileri kimlik doğrulaması için kullanılır.Tanınan değerler true, ile eşdeğer trueolan , yesfalse, , nove sspi (kesinlikle önerilir) değerleridir.Kullanıcı Kimliği ve Parola belirtilirse ve Tümleşik Güvenlik true olarak ayarlanırsa, Kullanıcı Kimliği ve Parola yoksayılır ve Tümleşik Güvenlik kullanılır. SqlCredential , SQL Server Kimlik Doğrulaması ( Integrated Security=false) kullanan bir bağlantı için kimlik bilgilerini belirtmenin daha güvenli bir yoludur. |
Max Pool Size |
100 | Havuzda izin verilen en fazla bağlantı sayısı. Geçerli değerler 1'den büyük veya buna eşittir. Minimum Havuz Boyutu'dan küçük değerler hata oluşturur. |
Min Pool Size |
0 | Havuzda izin verilen en az bağlantı sayısı. Geçerli değerler 0'dan büyük veya buna eşittir. Bu alandaki sıfır (0), başlangıçta en az bağlantı açılmaz anlamına gelir. En Büyük Havuz Boyutundan büyük değerler hata oluşturur. |
MultipleActiveResultSets |
'false' | olduğunda true, bir uygulama birden çok etkin sonuç kümesini (MARS) koruyabilir. olduğunda false, bir uygulamanın bu bağlantıda başka bir toplu işlemi yürütebilmesi için önce bir toplu işlemden tüm sonuç kümelerini işlemesi veya iptal etmesi gerekir.Tanınan değerler true ve false'dir.Daha fazla bilgi için bkz . Birden Çok Etkin Sonuç Kümesi (MARS). |
MultiSubnetFailover |
YANLIŞ | Sql Server 2012 (veya üzeri) kullanılabilirlik grubunun veya SQL Server 2012 (veya üzeri) Yük Devretme Kümesi Örneğinin kullanılabilirlik grubu dinleyicisine bağlanırken her zaman belirtin multiSubnetFailover=True .
multiSubnetFailover=True , (şu anda) etkin sunucuya daha hızlı algılama ve bağlantı sağlamak için SqlClient'ı yapılandırır. Olası değerler ve Nove FalseTrue veya 1 '0dırYes. Örneğin:MultiSubnetFailover=TrueVarsayılan değer: False. SqlClient'ın Always On AG desteği hakkında daha fazla bilgi için bkz. Yüksek Kullanılabilirlik için SqlClient Desteği, Olağanüstü Durum Kurtarma. |
Network Library-veya- Network-veya- Net |
N/A | SQL Server örneğine bağlantı kurmak için kullanılan ağ kitaplığı. Desteklenen değerler şunlardır: dbnmpntw (Adlandırılmış Kanallar) dbmsrpcn (Multiprotocol, Windows RPC) dbmsadsn (Apple Talk) dbmsgnet (VIA) dbmslpcn (Paylaşılan Bellek) dbmsspxn (IPX/SPX) dbmssocn (TCP/IP) Dbmsvinn (Banyan Vines) İlgili ağ DLL'sinin bağlandığınız sistemde yüklü olması gerekir. Bir ağ belirtmezseniz ve yerel bir sunucu kullanıyorsanız (örneğin, "." veya "(yerel)"), paylaşılan bellek kullanılır. Bu örnekte ağ kitaplığı Win32 Winsock TCP/IP (dbmssocn) ve 1433 kullanılan bağlantı noktasıdır. Network Library=dbmssocn;Data Source=000.000.000.000,1433; |
Packet Size |
8.000 | SQL Server örneğiyle iletişim kurmak için kullanılan ağ paketlerinin bayt cinsinden boyutu. Paket boyutu 512'den büyük veya buna eşit ve 32768'den küçük veya buna eşit olabilir. |
Password-veya- PWD |
N/A | Oturum açan SQL Server hesabının parolası. Tavsiye edilmez. Yüksek düzeyde güvenlik sağlamak için bunun yerine veya Trusted_Connection anahtar sözcüğünü Integrated Security kullanmanızı kesinlikle öneririz.
SqlCredential , SQL Server Kimlik Doğrulaması kullanan bir bağlantı için kimlik bilgilerini belirtmenin daha güvenli bir yoludur.Parola 128 karakter veya daha kısa olmalıdır. |
Persist Security Info-veya- PersistSecurityInfo |
'false' | veya no olarak ayarlandığında false (kesinlikle önerilir), bağlantı açıksa veya açık durumdaysa parola gibi güvenlik açısından hassas bilgiler bağlantının bir parçası olarak döndürülmüyor. Bağlantı dizesi sıfırlandığında parola da dahil olmak üzere tüm bağlantı dizesi değerleri sıfırlanır. Tanınan değerler , true, falseve yesdeğerleridirno. |
PoolBlockingPeriod |
Otomatik | Bağlantı havuzu için engelleme süresi davranışını ayarlar. Ayrıntılar için bkz PoolBlockingPeriod . özelliği. |
Pooling |
'true' | Bu anahtarın değeri true olarak ayarlandığında, uygulama tarafından kapatıldığında yeni oluşturulan tüm bağlantılar havuza eklenir. Bir sonraki aynı bağlantıyı açma girişiminde, bu bağlantı havuzdan çekilir. Bağlantılar aynı bağlantı dizesine sahipse aynı kabul edilir. Farklı bağlantıların farklı bağlantı dizeleri vardır. Bu anahtarın değeri "true", "false", "yes" veya "hayır" olabilir. |
Replication |
'false' |
true çoğaltma, bağlantı kullanılarak destekleniyorsa. |
Transaction Binding |
Örtük Bağlamayı Kaldırma | Listelenmiş bir işlemle bağlantı ilişkilendirmeyi System.Transactions denetler.Olası değerler şunlardır: Transaction Binding=Implicit Unbind;Transaction Binding=Explicit Unbind;Örtük Unbind, bağlantının sona erdiğinde işlemden ayrılmasına neden olur. Ayırma işleminden sonra, bağlantıdaki ek istekler otomatik komut modunda gerçekleştirilir. System.Transactions.Transaction.Current İşlem etkinken istekler yürütülürken özelliği denetlenmiyor. İşlem sona erdikten sonra, otomatik komut modunda ek istekler gerçekleştirilir.Sistem son komut tamamlanmadan önce işlemi (bir kullanan blok kapsamında) sona erdirirse, oluşturur InvalidOperationException. Açık Bağlama, bağlantı kapatılana veya açık SqlConnection.TransactionEnlist(null) çağrılana kadar bağlantının işleme bağlı kalmasına neden olur. .NET Framework 4'te başlayarak Örtük Unbind'de yapılan değişiklikler, Açık Bağlamasız'ı kullanımdan kaldırıyor.
InvalidOperationException Bir, listelenmiş işlem değilse veya listelenmiş işlem etkin değilse oluşturulurTransaction.Current. |
TransparentNetworkIPResolution |
Açıklamaya bakın. | Bu anahtarın değeri olarak trueayarlandığında, uygulamanın belirli bir DNS girdisinin tüm IP adreslerini alması ve listedeki ilk anahtarla bağlanmayı denemesi gerekir. Bağlantı 0,5 saniye içinde kurulmazsa, uygulama diğer tüm kullanıcılara paralel olarak bağlanmayı dener. İlk yanıtlar verildiğinde, uygulama yanıtlayan IP adresiyle bağlantı kurar.MultiSubnetFailover Anahtar olarak ayarlanırsa trueTransparentNetworkIPResolution yoksayılır.Failover Partner Anahtar ayarlandıysa TransparentNetworkIPResolution yoksayılır.Bu anahtarın değeri , , falseyesveya noolmalıdırtrue.değeri yes değeri ile aynı olarak truedeğerlendirilir.değeri no değeri ile aynı olarak falsedeğerlendirilir.Varsayılan değerler aşağıdaki gibidir:
|
TrustServerCertificate |
'false' | olarak trueayarlandığında SSL, güveni doğrulamak için sertifika zincirinde yürümeyi atlarken kanalı şifrelemek için kullanılır. TrustServerCertificate olarak ayarlanırsa true ve Şifreleme olarak ayarlanırsa false, kanal şifrelenmez. Tanınan değerler , true, falseve yesdeğerleridirno. Daha fazla bilgi için bkz. Bağlantı Dizesi Sözdizimi. |
Type System Version |
N/A | Uygulamanın beklediği tür sistemini gösteren dize değeri. İstemci uygulaması için kullanılabilen işlevsellik, SQL Server sürümüne ve veritabanının uyumluluk düzeyine bağlıdır. İstemci uygulamasının yazıldığı tür sistemi sürümünü açıkça ayarlamak, SQL Server'ın farklı bir sürümü kullanılırsa uygulamanın bozulmasına neden olabilecek olası sorunları önler.
Not: Tür sistemi sürümü, SQL Server'da işlem içinde yürütülen ortak dil çalışma zamanı (CLR) kodu için ayarlanamaz. Daha fazla bilgi için bkz. SQL Server Ortak Dil Çalışma Zamanı Tümleştirmesi. Olası değerler şunlardır: 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; uygulamanın Microsoft.SqlServer.Types.dll11.0.0.0 sürümünü gerektireceğini belirtir. Diğer Type System Version ayarlar için Microsoft.SqlServer.Types.dll10.0.0.0 sürümü gerekir.Latest kullanım dışıdır ve kullanılmamalıdır.
Latest eşdeğeri, Type System Version=SQL Server 2008; olur. |
User ID-veya- UID-veya- User |
N/A | SQL Server oturum açma hesabı. Tavsiye edilmez. Yüksek düzeyde güvenlik sağlamak için bunun yerine veya Trusted_Connection anahtar sözcüklerini kullanmanızı Integrated Security kesinlikle öneririz.
SqlCredential , SQL Server Kimlik Doğrulaması kullanan bir bağlantı için kimlik bilgilerini belirtmenin daha güvenli bir yoludur.Kullanıcı kimliği 128 karakter veya daha kısa olmalıdır. |
User Instance |
'false' | Bağlantının varsayılan SQL Server Express örneğinden çağıranın hesabı altında çalışan çalışma zamanı tarafından başlatılan bir örneğe yönlendirilip yönlendirilmeyeceğini gösteren değer. |
Workstation ID-veya- WSID |
Yerel bilgisayar adı | SQL Server'a bağlanan iş istasyonunun adı. Kimlik 128 karakter veya daha kısa olmalıdır. |
Aşağıdaki liste, içindeki ConnectionStringbağlantı havuzu değerleri için geçerli adları içerir. Daha fazla bilgi için SQL Server Bağlantı Havuzu (ADO.NET)'ne bakın.
-
Connection Lifetime(veyaLoad Balance Timeout) EnlistMax Pool SizeMin Pool SizePooling
Boole değeri gerektiren anahtar sözcük veya bağlantı havuzu değerleri ayarladığınızda yerine ve yerine kullanabilirsiniz yestrue.falseno Tamsayı değerleri dize olarak temsil edilir.
Uyarı
SQL Server için .NET Framework Veri Sağlayıcısı, SQL Server ile iletişim kurmak için kendi protokolünü kullanır. Bu nedenle, BIR ODBC katmanı eklemediğinden SQL Server'a bağlanırken ODBC veri kaynağı adı (DSN) kullanımını desteklemez.
Uyarı
Evrensel veri bağlantısı (UDL) dosyaları SQL Server için .NET Framework Veri Sağlayıcısı için desteklenmez.
Dikkat
Kullanıcı girişini temel alan bir bağlantı dizesi oluştururken (örneğin, bir iletişim kutusundan kullanıcı kimliği ve parola bilgilerini alırken ve bunu bağlantı dizesine eklerken) dikkatli olun. Kullanıcının bu değerlere ek bağlantı dizesi parametreleri ekleyemediğinden emin olun (örneğin, parolayı "validpassword; database=somedb" öğesini seçin. Kullanıcı girişine göre bağlantı dizeleri oluşturmanız gerekiyorsa, SqlConnectionStringBuilderbağlantı dizesini doğrulayan ve bu sorunu ortadan kaldırmaya yardımcı olan kullanın. Daha fazla bilgi için bkz . Bağlantı Dizesi Oluşturucuları.