connectionStrings Ögesi (ASP.NET Ayarlar Şeması)
ASP.NET uygulamaları ve özellikleri için ad/değer çiftleri biçiminde veritabanı bağlantısı dizeleri koleksiyonu belirtir.
Bu öge .NET Framework sürüm 2.0'da yenidir.
<connectionStrings >
<add />
<clear />
<remove />
</connectionStrings>
Öznitelikler ve Öğeler
Bu öge için öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.
Öznitelikler
Tüm bölüm ögeleri tarafından devralınan öznitelikler dışında yoktur. Daha fazla bilgi için bkz. Bölüm Ögeleri Tarafından Devralınan Genel Öznitelikler. ASP.NET uygulamasına, çalıştırma zamanında, ConfigSource özniteliğine alternatif bir yapılandırma dosyasının adını atayabilirsiniz. Bu durumda dosyanın içeriği, Web.config dosyasında yer alan varsayılan bağlantı dizesi bilgileri tarafından yeniden yazılır. Bu da, alternatif dosya yoksa ve çalıştırma zamanında oluşturulduysa ortaya çıkar. Web.config herhangi bir bağlantı dizesi bilgisi içermiyorsa, boş bir connectionStrings bölümü alternatif dosyaya eklenir.
Alt Öğeler
Öge |
Açıklama |
|---|---|
Add |
Bağlantı dizeleri koleksiyonuna ad/değer çifti olarak bir bağlantı dizesi ekler. |
Clear |
Devralınan bağlantı dizelerine yapılan tüm başvuruları kaldırır ve sadece geçerli add özniteliği tarafından eklenen bağlantı dizelerine izin verir. |
remove |
Bağlantı dizeleri koleksiyonundan devralınan bağlantı dizesine yapılan başvuruyu kaldırır. |
Üst Öğeler
Öge |
Açıklama |
|---|---|
configuration |
Ortak dil çalıştırma modülü ile .NET Framework uygulamaları tarafından kullanılan bütün yapılandırma dosyalarında yer alması gereken kök ögeyi belirtir. |
System.web |
Yapılandırma dosyasında ASP.NET yapılandırma ayarları için kök öge belirtir ve ASP.NET Web uygulamalarını yapılandıran ve uygulamaların davranışını denetleyen yapılandırma ögelerini içerir. |
Açıklamalar
connectionStrings ögesi, ASP.NET uygulamaları ve özellikleri için ad/değer çiftleri biçiminde veritabanı bağlantısı dizeleri koleksiyonu belirtir.
ASP.NET'in önceki sürümlerinde, bağlantı dizeleri appSettings içinde saklanırdı. ASP.NET 2.0'da, Session (Oturum), Membership (Üyelik), Personalization (Kişiselleştirme) ve Role Manager (Rol Yöneticisi) gibi özellikler connectionStrings ögesinde depolanan bağlantı dizelerini kullanır. Ayrıca, kendi uygulamalarınızda bağlantı dizesi depolamak için connectionStrings ögesini kullanabilirsiniz.
Varsayılan Yapılandırma
Üst yapılandırma dosyasının içerdiği bağlantı dizeleri, clear ögesi alt öge yapılandırma dosyasında kullanıldığı sürece devralınır. Aşağıdaki varsayılan connectionStrings ögesi Machine.config dosyasında yapılandırılır.
connectionStrings ögesine program aracılığıyla erişebilirsiniz. Daha fazla bilgi için, bkz. ConnectionStrings örneği.
<connectionStrings>
<add
name="LocalSqlServer"
connectionString="data source=.\SQLEXPRESS;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|aspnetdb.mdf;User Instance=true"
providerName="System.Data.SqlClient"
/>
</connectionStrings>
Örnek
Aşağıdaki kod örneğinde, iki bağlantı dizesinin nasıl yapılandırıldığı gösterilmektedir. İlk bağlantı dizesi, bir ASP.NET uygulaması tarafından kullanılabilir ve ikinci bağlantı dizesi, daha sonra yapılandırılmış olan sqlCacheDependency ögesi tarafından kullanılır.
<configuration>
<!-- Other configuration settings -->
<connectionStrings>
<add name="Sales"
providerName="System.Data.SqlClient"
connectionString= "server=myserver;database=Products;uid=<user name>;pwd=<secure password>" />
<add name="NorthWind"
providerName="System.Data.SqlClient"
connectionString="server=.;database=NorthWind;Integrated Security=SSPI" />
</connectionStrings>
<cache>
<sqlCacheDependency enabled="true" pollTime="60000">
<databases>
<add name="Northwind" />
</databases>
</sqlCacheDependency>
</cache>
</configuration>
Öğe Bilgileri
Yapılandırma bölümü işleyicisi |
|
Yapılandırma üyesi |
|
Yapılandırılabilir konumlar |
Machine.config Kök düzeyinde Web.config Uygulama düzeyinde Web.config Sanal veya fiziksel dizin düzeyinde Web.config |
Gereksinimler |
Microsoft Internet Information Services (IIS) sürüm 5.0, 5.1 veya 6.0 .NET Framework sürüm 2.0 Microsoft Visual Studio 2003 veya Visual Studio 2005 |
Ayrıca bkz.
Görevler
Nasıl Yapılır: ASP.NET Yapılandırması kilitlemek Ayarlar
Başvuru
configuration Ögesi (Genel Ayarlar Şeması)
connectionStrings için add Ögesi (ASP.NET Ayarlar Şeması)
connectionStrings için clear Ögesi (ASP.NET Ayarlar Şeması)
connectionStrings için remove Ögesi (ASP.NET Ayarlar Şeması)
Kavramlar
ASP.NET yapılandırmasına genel bakış
ASP.NET Yapılandırması güvenliğini sağlama
ASP.NET Veri Erişimine Genel Bakış
Oluşturmak için Uygulama Hizmetler veritabanı SQL sunucu
Veri erişim güvenliğini sağlama