Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.