appSettings Ögesi (Genel Ayarlar Şeması)
Bir uygulamaya ait dosya yolları, XML Web hizmeti URL'leri veya .ini dosyasında depolanan bilgi gibi özel uygulama ayarlarını içerir.
<appSettings
file="relative file name" >
</appSettings>
Öznitelikler ve Öğeler
Öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.
Öznitelikler
Öge |
Açıklama |
|---|---|
file |
İsteğe bağlı String özniteliği. Özel uygulama yapılandırma ayarlarını içeren harici dosyanın göreli yolunu belirtir. Belirtilen dosya, appSettings'teki ekle, sil ve kaldır özniteliklerinde belirtilenlerle aynı tür ayarları içerir ve bu ögelerle aynı anahtar/değer çifti biçimini kullanır. Belirtilen yol, yerel yapılandırma dosyası ile ilişkilidir. Belirtilen dosya bulunamazsa çalışma zamanı özniteliği yok sayar. Web.config dosyasındaki herhangi bir değişiklik uygulamanın yeniden başlamasına neden olacağı için, ayrı bir dosya kullanmak uygulamanın yeniden başlamasını engeller appSettings bölümündeki değerlerin değiştirilmesini sağlar. Bu dosyanın içeriği, Web.config dosyasındaki appSettings bölümü ile birleştirilir. Bu işlev, appSettings özniteliği ile sınırlıdır. Not .NET Framework sürüm 2.0'da, configSource özniteliğini destekleyen tüm yapılandırma ögeleri için yapılandırma ayarlarını ayrı bir dosyaya koyabilirsiniz. Ancak, configSource özniteliğini kullandığınızda öge ayarlarını birleştirme olanağınız olmadığı için tüm bölümü ayrı dosyaya taşımanız gerekir. Web.config dosyasına configSource özniteliği kullanılarak bir kez yazılabilir. Bu, uygulamanın yeniden başlamasına neden olur, ancak bölümün bundan sonraki güncelleştirmeleri doğrudan ayrı dosyaya yazılır ve sonraki uygulamanın yeniden başlaması engellenmiş olur. Daha fazla bilgi için bkz. ConfigSource. |
Devralınan öznitelikler |
İsteğe bağlı öznitelikler. Tüm bölüm ögeleri tarafından devralınan öznitelikler. |
Alt Öğeler
Öge |
Açıklama |
|---|---|
add |
İsteğe bağlı öğe. Özel uygulama ayarını uygulama ayarları koleksiyonuna ad/değer çifti olarak ekler. |
clear |
İsteğe bağlı öge. Devralınan özel uygulama ayarlarına yapılan tüm başvuruları kaldırır ve sadece geçerli ekle özniteliği tarafından eklenen başvurulara izin verir. |
remove |
İsteğe bağlı öge. Devralınan özel uygulama ayarı için uygulama ayarları koleksiyonundan başvuru 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
appSettings ögesi bir uygulamaya ait dosya yolları, XML Web servisi URL'leri veya .ini dosyasında depolanmış bilgi gibi özel uygulama yapılandırma bilgilerini depolar. appSettings ögesinde belirtilen anahtar/değer çiftlerine ConfigurationManager sınıfı kullanılarak koddan erişilebilir. Bakın nasıl erişileceği görmek için sınıfta gösterilen kod örneği appSettings programlı.
file özniteliğini, ek ayarlar sağlayan veya appSettings ögesinde belirtilen ayarları geçersiz kılan bir yapılandırma dosyası belirtmek için kullanabilirsiniz. file özniteliğini kaynak denetimi ekip geliştirme senaryolarında kullanabilirsiniz. (Örneğin, kullanıcının bir uygulama yapılandırma dosyasında belirtilen proje ayarlarını geçersiz kılmak istemesi.) file özniteliğinde belirtilen yapılandırma dosyalarında kök düğümü olarak yapılandırma ögesi yerine appSettings ögesi olmalıdır.
.NET Framework sürüm 2.0 uygulamalarında, uygulama ayarları koleksiyonu yerine connectionStrings Ögesi (ASP.NET Ayarlar Şeması) koleksiyonundaki veritabanı bağlantı dizelerini depolayınız.
Varsayılan Yapılandırma
Aşağıdaki varsayılan appSettings ögesi Machine.config dosyası veya kök Web.config dosyasında tam olarak yapılandırılmamıştır. Ancak bu, uygulamanın varsayılan yapılandırmasıdır.
<appSettings file="">
<settings>
<clear />
</settings>
</appSettings>
Örnek
file özniteliğinde belirtilen yapılandırma dosyalarında kök düğümü olarak yapılandırma ögesi yerine appSettings ögesi olmalıdır.
Aşağıdaki kod örneğinde file özniteliğinde belirtilen bir yapılandırma dosyası için doğru form kullanımı gösterilmiştir.
<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>
Aşağıdaki kod örneğinde, özel uygulama ayarının yapılandırma dosyasında nasıl tanımlandığı gösterilmiştir.
<configuration>
<appSettings>
<add key="Application Name" value="MyApplication" />
</appSettings>
</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) 5.0, 5.1 veya 6.0 .NET Framework sürüm 1.0, 1.1 veya 2.0 Microsoft Visual Studio 2003 veya Visual Studio 2005 |
Ayrıca bkz.
Başvuru
configuration Ögesi (Genel Ayarlar Şeması)
appSettings için add Ögesi (Genel Ayarlar Şeması)
appSettings için clear Ögesi (Genel Ayarlar Şeması)
appSettings için remove Ögesi (Genel Ayarlar Şeması)
Kavramlar
ASP.NET Yapılandırması güvenliğini sağlama
ASP.NET Yapılandırması senaryoları