<appSettings> 項目
包含自訂的應用程式設定。這是 .NET Framework 提供的預先定義組態區段。
<configuration>
<appSettings>
<appSettings file="relative file name">
</appSettings>
選擇性屬性
| 屬性 | 說明 |
|---|---|
| file | 指定至外部檔案的相對路徑，該檔案包含自訂的應用程式組態設定。指定的檔案所包含的設定類型與在 <add>、<remove> 和 <clear> 項目中所指定的相同，且使用與這些項目相同的索引鍵/值配對格式。
指定的路徑是相對於主組態檔。對 Windows Form 應用程式而言，這會是二進位資料夾 (例如 /bin/debug)，而不是應用程式組態檔的位置。對 Web Form 應用程式而言，這個路徑是相對於應用程式根目錄，也就是 web.config 檔案的位置。 請注意，如果找不到指定的檔案，Runtime 會忽略這個屬性。 |
子項目
| 項目 | 說明 |
|---|---|
| <add> | 加入自訂的應用程式設定。 |
| <remove> | 移除先前定義的應用程式設定。 |
| <clear> | 清除所有先前定義的應用程式設定。 |
備註
<appSettings> 項目儲存自訂的應用程式組態資訊，例如資料庫連接字串 (Connection String)、檔案路徑、XML Web Service URL 或儲存在應用程式的 .ini 檔案中的任何資訊。您可以在程式碼中，透過 System.Configuration.ConfigurationSettings 類別存取在 <appSettings> 項目中所指定的索引鍵/值配對。
您可以在 Web.config 和應用程式組態檔的 <appSettings> 項目中，使用 file 屬性。這個屬性所指定的組態檔，會提供額外的設定或覆寫在 <appSettings> 項目中指定的設定。file 屬性可以用在原始檔控制小組開發案例中，例如當使用者想要覆寫指定於應用程式組態檔中的專案設定時。
由 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 檔案中使用。