OdbcConnection.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.
Veri kaynağı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; }public string ConnectionString { get; set; }[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }member this.ConnectionString : string with get, set[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, setPublic Overrides Property ConnectionString As StringPublic Property ConnectionString As StringÖzellik Değeri
İlk bağlantıyı kurmak için gereken veri kaynağı adı gibi ayarları içeren ODBC sürücüsü bağlantı dizesi. Varsayılan değer boş bir dizedir (""). Uzunluk üst sınırı 1024 karakterdir.
Uygulamalar
- Öznitelikler
Açıklamalar
ConnectionString özelliği ODBC bağlantı dizesi biçimiyle mümkün olduğunca yakından eşleşecek şekilde tasarlanmıştır. ConnectionString yalnızca bağlantı kapatıldığında ve ayarlanır ayarlanmaz Sürücü Yöneticisi'ne ve temel alınan sürücüye geçirildiğinde ayarlanabilir. Bu nedenle, için ConnectionString söz dizimi Sürücü Yöneticisi ve temel sürücü desteği ile tam olarak eşleşmelidir.
çeşitli veri kaynaklarına bağlanmak için özelliğini kullanabilirsiniz ConnectionString . Buna ODBC veri kaynağı adı (DSN) dahildir. Aşağıdaki örnekte birkaç olası bağlantı dizesi gösterilmektedir.
"Driver={SQL Server};Server=(local);Trusted_Connection=Yes;Database=AdventureWorks;"
"Driver={Microsoft ODBC for Oracle};Server=ORACLE8i7;Persist Security Info=False;Trusted_Connection=Yes"
"Driver={Microsoft Access Driver (*.mdb)};DBQ=c:\bin\Northwind.mdb"
"Driver={Microsoft Excel Driver (*.xls)};DBQ=c:\bin\book1.xls"
"Driver={Microsoft Text Driver (*.txt; *.csv)};DBQ=c:\bin"
"DSN=dsnname"
Uyarı
ODBC için .NET Framework Veri Sağlayıcısı, diğer .NET Framework veri sağlayıcıları tarafından desteklenen anahtar sözcüğü desteklemez Persist Security Info . Ancak özelliği ConnectionString olarak ayarlanmış falsegibi Persist Security Info davranır. Bu, bağlantı açıldıysa özelliğinden ConnectionString parolayı alamayacağınız anlamına gelir.
ConnectionString Özelliği açılmış bir OdbcConnection nesneden okunduğunda, bağlantı dizesi paroladan çıkarılarak döndürülür. Bu davranışı değiştiremezsiniz; bu nedenle, uygulama parola gerektiriyorsa, çağırmadan Openönce ayrı olarak depolayın.
Dizede belirtilen ayarların birçoğuna karşılık gelen salt okunur özellikler (örneğin, Server=(local)özelliğine DataSource karşılık gelen ) vardır. Bu özellikler, bağlantı açıldıktan sonra bir hata algılandığında güncelleştirilir. Bu durumda, özelliklerin hiçbiri güncelleştirilmez.
OdbcConnection özellikleri (örneğin Database), yalnızca varsayılan ayarları veya içinde ConnectionStringbelirtilen ayarları döndürür.
Bağlantı dizesinde bazı temel doğrulama işlemleri, siz özelliği ayarladığınız ConnectionString anda gerçekleşir. Bu sırada, veri sağlayıcısı bağlantı dizesinin "anahtar sözcük=değer;..." ile eşleşdiğini doğrular biçimindedir, ancak anahtar sözcüklerin veya değerlerin geçerli olup olmadığını doğrulamaz. Kalan doğrulama, uygulama yöntemini çağırdığında Open temel odbc sürücüsü tarafından gerçekleştirilir.
ODBC bağlantı dizesi aşağıdaki söz dizimine sahiptir:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=attribute-value | DRIVER=[{]attribute-value[}]
attribute-keyword ::= DSN | UID | PWD
| driver-defined-attribute-keyword
attribute-value ::= character-string
driver-defined-attribute-keyword ::= identifier
burada character-string sıfır veya daha fazla karakter vardır; identifier bir veya daha fazla karaktere sahiptir; attribute-keyword büyük/küçük harfe duyarlı değildir; attribute-value büyük/küçük harfe duyarlı olabilir; DSN anahtar sözcüğü değeri yalnızca boşluklardan oluşmaz.
Bağlantı dizesi ve başlatma dosyası dil bilgisi nedeniyle, []{}(),;? karakterlerini içeren anahtar sözcüklerden ve öznitelik değerlerinden kaçınılmalıdır. *=!@ ayraç içine alınmaz. DSN anahtar sözcüğü değeri yalnızca boşluklardan oluşamaz ve baştaki boşlukları içermemelidir. Sistem bilgilerinin dil bilgisi nedeniyle anahtar sözcükler ve veri kaynağı adları ters eğik çizgi (\) karakterini içeremez.
Öznitelik noktalı virgül (;) içermediği sürece, uygulamaların Driver anahtar sözcüğünden sonra öznitelik değerinin çevresine ayraç eklemesi gerekmez; bu durumda küme ayraçları gereklidir. Sürücünün aldığı öznitelik değeri küme ayraçları içeriyorsa, sürücü bunları kaldırmamalıdır, ancak döndürülen bağlantı dizesinin bir parçası olmalıdır.
[]{}(),;? karakterlerinden herhangi birini içeren ayraç ({}) içine alınmış bir DSN veya bağlantı dizesi değeri *=!@ sürücüye dokunulmadan geçirilir. Ancak, bu karakterleri bir anahtar sözcükte kullandığınızda, Sürücü Yöneticisi dosya DSN'leri ile çalıştığınızda bir hata döndürür, ancak normal bağlantı dizeleri için bağlantı dizesini sürücüye geçirir. Bir anahtar sözcük değerinde katıştırılmış küme ayraçları kullanmaktan kaçının.
Bağlantı dizesi herhangi bir sayıda sürücü tanımlı anahtar sözcük içerebilir. DRIVER anahtar sözcüğü sistemdeki bilgileri kullanmadığından, sürücünün yalnızca bağlantı dizesindeki bilgileri kullanarak bir veri kaynağına bağlanabilmesi için yeterli anahtar sözcük tanımlaması gerekir. Sürücü, veri kaynağına bağlanmak için hangi anahtar sözcüklerin gerekli olduğunu tanımlar.
Bağlantı dizesinde herhangi bir anahtar sözcük yinelenirse, hangi değerin seçileceğinin garantisi yoktur.
Uyarı
ODBC sürücüsü 1024 karakterden uzun bağlantı dizelerini destekliyorsa, uzunluk sınırı üst sınırını aşmak için veri kaynağı adı (DSN) kullanabilirsiniz.
