<appSettings>, element konfiguracji <>

  • Artykuł

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.

Zobacz też