<appSettings>, element konfiguracji <>
Zawiera niestandardowe ustawienia aplikacji. Jest to wstępnie zdefiniowana sekcja konfiguracji udostępniona przez .NET Framework.
<Konfiguracji>
<Appsettings>
Składnia
<appSettings>
<!-- Elements to add, clear, or remove configuration settings -->
</appSettings>
Atrybut
| Opis | |
|---|---|
| Plik | Atrybut opcjonalny. Określa ścieżkę względną do pliku zewnętrznego zawierającego niestandardowe ustawienia konfiguracji aplikacji. Określony plik zawiera takie same ustawienia, które są określone w elementach <dodawania>, <usuwania> i <czyszczenia> oraz używają tego samego formatu pary klucz/wartość co te elementy. Określona ścieżka jest względna względem głównego pliku konfiguracji. W przypadku aplikacji Windows Forms jest to folder binarny (taki jak /bin/debug), a nie lokalizacja pliku konfiguracji aplikacji. W przypadku aplikacji Web Forms ścieżka jest względna względem katalogu głównego aplikacji, w którym znajduje się plik web.config. Środowisko uruchomieniowe ignoruje atrybut, jeśli nie można odnaleźć określonego pliku. |
Element nadrzędny
| Opis | |
|---|---|
| <configuration> , element | Element główny w każdym pliku konfiguracji używanym przez środowisko uruchomieniowe języka wspólnego i aplikacje programu .NET Framework. |
Elementy podrzędne
| Opis | |
|---|---|
| <Dodaj> | Dodaje ustawienie aplikacji niestandardowej. |
| <Wyczyść> | Czyści wszystkie wcześniej zdefiniowane ustawienia aplikacji. |
| <Usunąć> | Usuwa wcześniej zdefiniowane ustawienie aplikacji. |
Uwagi
Element <appSettings> przechowuje niestandardowe informacje o konfiguracji aplikacji, takie jak parametry połączenia bazy danych, ścieżki plików, adresy URL usługi sieci Web XML lub inne niestandardowe informacje o konfiguracji aplikacji. Pary klucz/wartość określone w <elemecie appSettings> są dostępne w kodzie przy użyciu ConfigurationSettings klasy .
Atrybut pliku można użyć w <elemecie appSettings> plików konfiguracjiWeb.configi aplikacji. Ten atrybut określa plik konfiguracji, który udostępnia dodatkowe ustawienia lub zastępuje ustawienia określone w <elemecie appSettings> . Atrybut pliku może być używany w scenariuszach tworzenia zespołu kontroli źródła, na przykład gdy użytkownik chce zastąpić ustawienia projektu określone w pliku konfiguracji aplikacji.
Pliki konfiguracji określone przez atrybut pliku muszą mieć węzeł <główny appSettings> , a nie <konfigurację>.
Przykład
W poniższym przykładzie przedstawiono plik ustawień aplikacji zewnętrznych (custom.config), który definiuje niestandardowe ustawienie aplikacji:
<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>
W poniższym przykładzie przedstawiono plik konfiguracji aplikacji, który używa ustawienia w pliku ustawień zewnętrznych i ustawia własne ustawienie aplikacji:
<configuration>
<appSettings file="custom.config">
<add key="ApplicationName" value="MyApplication" />
</appSettings>
</configuration>
Plik konfiguracji
Ten element może być używany w pliku konfiguracji aplikacji, pliku konfiguracji maszyny (Machine.config) i Web.config plików, które nie znajdują się na poziomie katalogu aplikacji.
