共用方式為


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>

項目資訊

組態區段處理常式

AppSettingsSection

組態成員

Add

可設定的位置

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 項目 (一般設定結構描述)

configuration 項目 (一般設定結構描述)

appSettings 的 clear 項目 (一般設定結構描述)

appSettings 的 remove 項目 (一般設定結構描述)

概念

Securing Configuration

Configuration Inheritance

其他資源

一般組態設定 (ASP.NET)

ASP.NET 組態設定

ASP.NET Configuration Files