appSettings Element (schemat ustawień ogólne)
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Zawiera ustawienia niestandardowej aplikacji, takich jak ścieżki plików, adresy URL usługi XML sieci Web lub wszelkie informacje, które są przechowywane w pliku the.ini dla aplikacji.
<appSettings
file="relative file name" >
</appSettings>
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne.
Atrybuty
Element |
Opis |
|---|---|
file |
Opcjonalny String atrybut. Określa ścieżkę względną do zewnętrznego pliku, który zawiera ustawienia konfiguracji niestandardowych aplikacji. Określony plik zawiera ten sam rodzaj ustawienia, które są określone w appSettingsdodać, Wyczyść, i usunąć atrybuty i używa tego samego formatu para klucz i wartość jako tych elementów. Ścieżki określonej jest plik konfiguracji lokalnej. Aparat plików wykonywalnych ignoruje atrybut, jeśli nie można odnaleźć określonego pliku. Ponieważ zmiany w pliku Web.config spowodować ponowne uruchomienie aplikacji, użycie osobnego pliku umożliwia użytkownikom modyfikowanie wartości, które znajdują się w appSettings sekcji, nie powodując ponowne uruchomienie aplikacji. Zawartość pliku oddzielnych są scalane z appSettings w sekcji w pliku Web.config. Funkcja ta jest ograniczona do appSettings atrybut. Uwaga W.NET Framework w wersji 2.0, można teraz dołączyć ustawienia konfiguracji w oddzielnym pliku dla wszystkich elementów konfiguracji, które obsługują configSource atrybut. Jednakże, gdy korzystasz z configSource atrybutu, należy przenieść całą sekcję do oddzielnego pliku, ponieważ nie ma żadnych scalanie ustawienia elementu. Brak jednorazowego zapisu do pliku Web.config, po użyciu configSource atrybut. Powoduje to, że ponowne uruchomienie aplikacji, ale kolejne aktualizacje do sekcji są zapisywane bezpośrednio w oddzielnym pliku i nie mogą powodować kolejnych aplikacja zostanie uruchomiona ponownie. Aby uzyskać więcej informacji, zobacz ConfigSource. |
Atrybuty dziedziczone |
Opcjonalne atrybuty. Atrybuty dziedziczone przez wszystkie elementy z sekcji. |
Elementy podrzędne
Element |
Opis |
|---|---|
add |
Opcjonalnego elementu. Dodaje ustawienie niestandardowych aplikacji jako pary nazwa/wartość do kolekcji ustawień aplikacji. |
clear |
Opcjonalnego elementu. Usuwa wszystkie odwołania do ustawienia dziedziczone niestandardowych aplikacji i umożliwia tylko odwołań, które są dodawane przez bieżący dodać atrybut. |
remove |
Opcjonalnego elementu. Usuwa odwołanie do ustawienia dziedziczone niestandardowych aplikacji z kolekcji ustawień aplikacji. |
Elementy nadrzędne
Element |
Opis |
|---|---|
configuration |
Określa element główny wymagane w każdym pliku konfiguracyjnym, który jest używany przez aparatu plików wykonywalnych języka wspólnego oraz.NET Framework aplikacji. |
system.web |
Określa element główny dla aplikacji ASP.Ustawienia konfiguracji netto w konfiguracji pliku i zawiera elementy konfiguracyjne określające konfigurację programu ASP.NET aplikacje sieci Web i kontrolować zachowanie tych aplikacji. |
Uwagi
appSettings Element przechowuje informacje o konfiguracji aplikacji niestandardowych, takich jak ścieżki plików, adresy URL usługi XML sieci Web lub wszelkie informacje, które są przechowywane w pliku the.ini dla aplikacji. Par klucz wartość, które są określone w appSettings elementu można uzyskać dostęp przy użyciu kodu ConfigurationManager klasy. Można znaleźć w przykładzie kodu pokazano w klasie, aby zobaczyć sposób uzyskiwania dostępu do appSettings programowo.
Można użyć file atrybutu, aby określić plik konfiguracyjny, który udostępnia dodatkowe ustawienia lub zastępuje ustawienia, które są określone w appSettings element. Można użyć file atrybutu w źródła kontroli zespołu rozwoju scenariusze, takie jak na przykład gdy użytkownik chce, aby zastąpić ustawienia projektu, które są określone w pliku konfiguracyjnym aplikacji. Pliki konfiguracyjne, które są określone w file musi mieć atrybut appSettings elementu zamiast konfiguracji element jako węzeł główny.
W.NET Framework w wersji 2.0 aplikacje, przechowywać ciągi połączeń bazy danych w connectionStrings Element (ASP.Schemat ustawień netto) kolekcji zamiast zbioru ustawień aplikacji.
Domyślna konfiguracja
Następujące domyślne appSettings element nie jest jawnie skonfigurowane w pliku Machine.config lub głównego pliku Web.config. Jednakże jest domyślnej konfiguracji, który jest zwracany przez aplikację.
<appSettings file="">
<settings>
<clear />
</settings>
</appSettings>
Przykład
Pliki konfiguracyjne, które są określone w file musi mieć atrybut appSettings element raczej niż konfiguracji element jako węzeł główny.
Poniższy przykład kodu demonstruje, jak formularz prawidłowego pliku konfiguracji, która jest określona w file atrybut.
<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>
Poniższy przykład kodu pokazuje jak zdefiniować ustawienia niestandardowej aplikacji w pliku konfiguracyjnym.
<configuration>
<appSettings>
<add key="Application Name" value="MyApplication" />
</appSettings>
</configuration>
Informacje o elementach
Program obsługi sekcji konfiguracji |
|
Członkowskie konfiguracji |
|
Lokalizacje konfigurowalne |
Machine.config Web.config na poziomie katalogu głównego Poziom aplikacji Web.config Directory–level wirtualnego lub fizycznego Web.config |
Wymagania |
Microsoft Internet Information Services (IIS) 5.0, 5.1 lub 6.0 .NET Framework w wersji 1.0, 1.1 lub 2.0 Microsoft Visual Studio 2003 lub Visual Studio 2005 |
Zobacz też
Informacje
Konfiguracja elementu (schemat ustawień ogólne)
Dodawanie elementu do appSettings (schemat ustawień ogólne)
Usuń zaznaczenie elementu dla appSettings (schemat ustawień ogólne)
Usuń Element dla appSettings (schemat ustawień ogólne)
Koncepcje
Inne zasoby
Ogólne ustawienia konfiguracji (ASP.(NET)