appSettings 的 add 項目 (一般設定結構描述)
將自訂應用程式設定當做名稱/值組,加入至應用程式設定的集合。
<add
key="String name"
value="String value"
/>
屬性和項目
下列章節會說明屬性、子項目和父項目。
屬性
屬性 |
描述 |
---|---|
key |
必要的 String 屬性。 指定應用程式設定的名稱。 這個屬性是集合機碼。 |
value |
必要的 String 屬性。 指定應用程式設定的值。 |
繼承的屬性 |
選擇性屬性。 由所有區段項目所繼承的屬性。 如需詳細資訊,請參閱 Section 項目繼承的一般屬性。 |
子項目
無。
父項目
項目 |
描述 |
---|---|
configuration |
指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。 |
system.web |
指定組態檔中 ASP.NET 組態設定的根項目 (Root Element),並包含會設定 ASP.NET Web 應用程式以及控制這些應用程式之行為的組態項目。 |
appSettings |
包含自訂應用程式的設定,例如檔案路徑、XML Web 服務 URL,或是儲存在應用程式 .ini 檔內的任何資訊。 |
備註
add 項目會將自訂應用程式設定當做名稱/值組,加入至 appSettings 項目中繼承之應用程式設定的集合。
重要
索引鍵必須是唯一的。如果您加入多個含有相同索引鍵的項目,只會保留最後一個項目。
appSettings 項目會儲存自訂的應用程式組態資訊,例如檔案路徑、XML Web Service URL,或是儲存在應用程式 .ini 檔內的任何資訊。 可以使用 ConfigurationSettings 類別,在程式碼中存取 appSettings 項目內所指定的索引鍵/值組。 類別範例將示範如何以程式設計方式存取 appSettings 區段。
預設組態
在 .NET Framework 1.0 和 1.1 版中,下列預設 appSettings 項目是設定在 Machine.config 檔案中。
<appSettings>
<add key="XML File Name" value="myXmlFileName.xml" />
</appSettings>
範例
file 屬性中指定之組態檔的根節點必須是 appSettings,而不是 configuration。 下列程式碼對 file 屬性中指定的組態檔而言是正確的。
<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>
下列程式碼範例將顯示如何在組態檔中定義自訂的應用程式設定。
<configuration>
<appSettings>
<add key="Application Name" value="MyApplication" />
</appSettings>
</configuration>
項目資訊
組態區段處理常式 |
|
組態成員 |
|
可設定的位置 |
Machine.config 根層次的 Web.config 應用程式層級的 Web.config 虛擬或實體目錄層級的 Web.config |
需求 |
Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版 .NET Framework 1.0、1.1 或 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
請參閱
參考
appSettings 的 clear 項目 (一般設定結構描述)
appSettings 的 remove 項目 (一般設定結構描述)