ADO.NET bağlantı dizeleri

Şunlar için geçerlidir: .NET Framework .NET .NET Standard

ADO.NET indirin

bağlantı dizesi, veri sağlayıcısından veri kaynağına parametre olarak geçirilen başlatma bilgilerini içerir. Veri sağlayıcısı özelliğin değeri DbConnection.ConnectionString olarak bağlantı dizesi alır. Sağlayıcı bağlantı dizesi ayrıştırarak söz diziminin doğru olduğundan ve anahtar sözcüklerin desteklendiğinden emin olun. Ardından yöntemi ayrıştırılan DbConnection.Open() bağlantı parametrelerini veri kaynağına geçirir. Veri kaynağı daha fazla doğrulama gerçekleştirir ve bir bağlantı kurar.

Bağlantı dizesi söz dizimi

bağlantı dizesi, anahtar/değer parametre çiftlerinin noktalı virgülle ayrılmış listesidir:

keyword1=value; keyword2=value;

Anahtar sözcükler büyük/küçük harfe duyarlı değildir. Ancak değerler, veri kaynağına bağlı olarak büyük/küçük harfe duyarlı olabilir. Hem anahtar sözcükler hem de değerler boşluk karakterleri içerebilir. Anahtar sözcüklerde ve tırnak içinde olmayan değerlerde baştaki ve sondaki boşluk yoksayılır.

Bir değer noktalı virgül, Unicode denetim karakterleri veya başında veya sonunda boşluk içeriyorsa, tek veya çift tırnak içine alınmalıdır. Örneğin:

Keyword=" whitespace  ";
Keyword='special;character';

Kapsayan karakter, içine aldığınız değer içinde gerçekleşmeyebilir. Bu nedenle, tek tırnak işareti içeren bir değer yalnızca çift tırnak içine alınabilir ve tam tersi de olabilir:

Keyword='double"quotation;mark';
Keyword="single'quotation;mark";

Ayrıca, iki karakteri birlikte kullanarak da kapsayan karakterden kaçabilirsiniz:

Keyword="double""quotation";
Keyword='single''quotation';

Tırnak işaretleri ve eşittir işareti, kaçış gerektirmez, bu nedenle aşağıdaki bağlantı dizesi geçerlidir:

Keyword=no "escaping" 'required';
Keyword=a=b=c

Her değer bir sonraki noktalı virgüle veya dizenin sonuna kadar okunduğu için, ikinci örnekteki değer olur a=b=cve son noktalı virgül isteğe bağlıdır.

Tüm bağlantı dizeleri yukarıda açıklanan temel söz dizimini paylaşır. Tanınan anahtar sözcükler kümesi sağlayıcıya bağlıdır. SQL Server için Microsoft SqlClient veri sağlayıcısı, eski API'lerden birçok anahtar sözcüğü destekler, ancak genellikle daha esnektir ve ortak bağlantı dizesi anahtar sözcüklerinin çoğu için eş anlamlıları kabul eder.

Yazma hataları hatalara neden olabilir. Örneğin, Integrated Security=true geçerli, ancak IntegratedSecurity=true bir hataya neden olur.

Geçersiz kılınan kullanıcı girişlerinden çalışma zamanında el ile oluşturulmuş bağlantı dizeleri dize ekleme saldırılarına karşı savunmasızdır ve veri kaynağındaki güvenliği tehlikeye atabilir. Bu sorunları SqlConnectionStringBuilder gidermek için sınıfı oluşturulmuştur. Bu bağlantı dizesi oluşturucu sınıfı, parametreleri kesin olarak yazılan özellikler olarak kullanıma sunar ve veri kaynağına gönderilmeden önce bağlantı dizesini doğrulamayı mümkün kılar.

Bu bölümde

Bağlantı Dizesi Oluşturucusu
Çalışma zamanında geçerli bağlantı dizeleri oluşturmak için sınıfının nasıl kullanılacağını ConnectionStringBuilder gösterir.

Bağlantı Dizeleri ve Yapılandırma Dosyaları
Yapılandırma dosyalarında bağlantı dizesi depolamayı ve almayı gösterir.

Bağlantı Dizesi Söz Dizimi
için SqlClientsağlayıcıya özgü bağlantı dizelerinin nasıl yapılandırıldığı açıklanır.

Bağlantı Bilgilerini Koruma
Bir veri kaynağına bağlanmak için kullanılan bilgileri korumaya yönelik teknikleri gösterir.

Ayrıca bakınız

• SQL Server için Microsoft ADO.NET