Instrukcje: odczytywanie ustawień aplikacji

Uwaga / Notatka

Ten artykuł jest specyficzny dla programu .NET Framework. Nie ma zastosowania do nowszych implementacji platformy .NET, w tym .NET 6 i nowszych wersji.

W tym artykule pokazano, jak dodać proste ustawienie do pliku App.config w aplikacji .NET Framework, a następnie odczytać wartość programowo. Zamiast odczytywać pojedynczą wartość, możesz odczytać całą sekcję lub cały plik. Aby uzyskać więcej przykładów i informacji, zobacz dokumentację ConfigurationManager .

Dodawanie pliku App.config

Program Visual Studio ułatwia dodawanie pliku App.config do projektu. Po utworzeniu projektu .NET Framework kliknij prawym przyciskiem myszy projekt w Eksploratorze rozwiązań i wybierz polecenie Dodaj>nowy element. Wybierz element Plik konfiguracji aplikacji , a następnie wybierz pozycję Dodaj.

Dodawanie ustawienia

Otwórz plik App.config i dodaj następujący kod XML w elemecie <configuration> .

  <appSettings>
    <add key="occupation" value="dentist"/>
  </appSettings>

Programowe uzyskiwanie dostępu do ustawienia

Aby uzyskać dostęp do wartości ustawienia w swoim kodzie, pobierz wartość poprzez zindeksowanie właściwości AppSettings. Właściwość AppSettings ułatwia uzyskiwanie danych z <appSettings> elementu pliku konfiguracji.

string occupation = ConfigurationManager.AppSettings["occupation"];

Konfiguracja bibliotek

Chociaż pliki konfiguracji dla aplikacji wykonywalnych są proste, jest to nieco bardziej skomplikowane w przypadku bibliotek klas. Biblioteki klas mogą uzyskiwać dostęp do ustawień konfiguracji w taki sam sposób jak aplikacje wykonywalne, jednak ustawienia konfiguracji muszą istnieć w pliku App.config aplikacji klienckiej. Nawet jeśli dystrybuujesz plik App.config obok pliku zestawu biblioteki, kod biblioteki nie odczyta pliku. Alternatywnie rozważ następujące sposoby używania ustawień konfiguracji w bibliotece klas:

• Uzyskaj ustawienia konfiguracji w aplikacji klienckiej i przekaż je do klasy tworzonej z biblioteki klas.
• Zaimplementuj niestandardowy typ sekcji, który rozszerza klasę ConfigurationSection . Zachowaj oddzielny plik konfiguracji dla biblioteki klas, a następnie odwołuj się do pliku konfiguracji biblioteki z pliku konfiguracji aplikacji klienckiej. Aby uzyskać więcej informacji, zobacz How to: Create Custom Configuration Sections Using ConfigurationSection (Instrukcje: tworzenie niestandardowych sekcji konfiguracji przy użyciu konfiguracji).

Zobacz także

• System.Configuration.ConfigurationManager