<configuration> 的 <appSettings> 元素
包含自訂應用程式設定。 這是.NET Framework所提供的預先定義組態區段。
<configuration>
<appSettings>
Syntax
<appSettings>
<!-- Elements to add, clear, or remove configuration settings -->
</appSettings>
屬性
| 描述 | |
|---|---|
| file | 選擇性屬性。 指定包含自訂應用程式組態設定之外部檔案的相對路徑。 指定的檔案所包含的設定，與 <add>、<remove> 和 <clear> 元素中所指定的設定為相同的種類，且指定的檔案使用與這些元素相同的索引鍵/值組格式。 指定的路徑相對於主要組態檔。 若為 Windows Forms 應用程式，會是二進位資料夾 (例如 /bin/debug)，而不是應用程式組態檔的位置。 對於 Web Forms 應用程式來說，路徑會相對於 web.config 檔案所在的應用程式根目錄。 如果找不到指定的檔案，則執行階段會略過此屬性。 |
父元素
| 描述 | |
|---|---|
| <configuration> 元素 | 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。 |
子元素
| 描述 | |
|---|---|
| <add> | 新增自訂應用程式設定。 |
| <clear> | 清除所有先前定義的應用程式設定。 |
| <remove> | 移除先前定義的應用程式設定。 |
備註
<appSettings> 元素會儲存自訂應用程式的組態資訊，例如資料庫連接字串、檔案路徑、XML Web 服務 URL 或任何其他自訂的應用程式組態資訊。 <appSettings> 元素中所指定的索引鍵/值組，在程式碼中可使用 ConfigurationSettings 類別存取。
您可以在 Web.config 和應用程式組態檔的 <appSettings> 元素中，使用file 屬性。 此屬性可指定一個組態檔，提供其他設定或是覆寫 <appSettings> 元素中所指定的設定。 file 屬性可用於原始檔控制小組開發案例，例如當使用者想要覆寫應用程式組態檔中所指定的專案設定時。
file 屬性所指定的組態檔，必須要有 <appSettings> (而非 <configuration>) 的根節點。
範例
下列範例會顯示定義自訂應用程式設定的外部應用程式設定檔 (custom.config)：
<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>
下列範例會顯示應用程式組態檔，該檔案會取用外部設定檔中的設定，並設定其專屬的應用程式設定：
<configuration>
<appSettings file="custom.config">
<add key="ApplicationName" value="MyApplication" />
</appSettings>
</configuration>
組態檔
應用程式組態檔、電腦組態檔 (Machine.config) 與不在應用程式目錄層級的 Web.config 檔案中，皆可使用此元素。
