appSettings için add Ögesi (Genel Ayarlar Şeması)

Makale
08/01/2011

Özel uygulama ayarını uygulama ayarları koleksiyonuna ad/değer çifti olarak ekler.

<add
   key="String name"
   value="String value"
/>

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik	Açıklama
key	Gerekli String özniteliği. Uygulama ayarı adı belirtir. Bu öznitelik koleksiyon anahtarıdır.
value	Gerekli String özniteliği. Uygulama ayarının değerini belirtir.
Devralınan öznitelikler	İsteğe bağlı öznitelikler. Tüm bölüm ögeleri tarafından devralınan öznitelikler. Daha fazla bilgi için bkz. Bölüm Ögeleri Tarafından Devralınan Genel Öznitelikler.

key

Gerekli String özniteliği.

Uygulama ayarı adı belirtir. Bu öznitelik koleksiyon anahtarıdır.

value

Gerekli String özniteliği.

Uygulama ayarının değerini belirtir.

Devralınan öznitelikler

İsteğe bağlı öznitelikler.

Tüm bölüm ögeleri tarafından devralınan öznitelikler. Daha fazla bilgi için bkz. Bölüm Ögeleri Tarafından Devralınan Genel Öznitelikler.

Alt Öğeler

Yok.

Üst Öğeler

Öge	Açyklama
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.
appSettings	Bir uygulamaya ait dosya yolları, XML Web hizmeti URL'leri veya .ini dosyasında depolanan bilgi gibi özel uygulama ayarlarını içerir.

Açıklamalar

add ögesi, appSettings ögesindeki devralınan uygulama ayarları koleksiyonuna ad/değer çifti olarak özel uygulama ayarı ekler.

Önemli
Anahtarlarının benzersiz olması gerekir.Aynı sahip birden çok girdi eklerseniz, anahtar yalnızca son giriş korunur.

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 ConfigurationSettings sınıfı kullanılarak koddan erişilebilir. Sınıf örnek nasıl erişeceğinizi gösterir appSettings programlı.

Varsayılan Yapılandırma

.NET Framework sürüm 1.0 ve 1.1'de, aşağıdaki varsayılan appSettings ögesi Machine.config dosyası içinde yapılandırılmıştır.

<appSettings>
        <add key="XML File Name" value="myXmlFileName.xml" /> 
    </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, file özniteliğinde belirtilen bir yapılandırma dosyası için doğrudur.

<?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ü İşleyicisi	AppSettingsSection
Yapılandırma üyesi	Add
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 1.0, 1.1 veya 2.0 Microsoft Visual Studio 2003 veya Visual Studio 2005

Ayrıca bkz.

Aracılığıyla paylaş