Freigeben über

Konfigurieren von Apps mithilfe von Konfigurationsdateien

Hinweis

Dieser Artikel ist spezifisch für .NET Framework. Sie gilt nicht für neuere Implementierungen von .NET, einschließlich .NET 6 und höherer Versionen.

.NET Framework bietet Entwicklern und Administratoren Kontrolle und Flexibilität bei der Ausführung von Anwendungen über Konfigurationsdateien. Konfigurationsdateien sind XML-Dateien, die bei Bedarf geändert werden können. Ein Administrator kann steuern, auf welche geschützten Ressourcen eine Anwendung zugreifen kann, welche Versionen von Assemblies eine Anwendung verwenden wird und wo sich Remoteanwendungen und -objekte befinden. Entwickler können Einstellungen in Konfigurationsdateien einfügen, ohne dass eine Anwendung bei jeder Änderung einer Einstellung neu kompiliert werden muss. In diesem Abschnitt wird beschrieben, was konfiguriert werden kann und warum die Konfiguration einer Anwendung hilfreich sein kann.

Hinweis

Verwalteter Code kann die Klassen im System.Configuration Namespace verwenden, um Einstellungen aus den Konfigurationsdateien zu lesen, aber nicht zum Schreiben von Einstellungen in diese Dateien.

In diesem Artikel werden die Syntax von Konfigurationsdateien beschrieben und Informationen zu den drei Arten von Konfigurationsdateien bereitgestellt: Computer, Anwendung und Sicherheit.

Konfigurationsdateiformat

Konfigurationsdateien enthalten Elemente, die logische Datenstrukturen sind, die Konfigurationsinformationen festlegen. In einer Konfigurationsdatei verwenden Sie Tags, um den Anfang und das Ende eines Elements zu markieren. Beispielsweise besteht das <runtime> Element aus <runtime>untergeordneten Elementen</runtime>. Ein leeres Element würde als <runtime/> oder <runtime></runtime> geschrieben.

Wie bei allen XML-Dateien ist die Syntax in Konfigurationsdateien case-sensitive.

Sie geben Konfigurationseinstellungen mithilfe vordefinierter Attribute an, bei denen es sich um Namen-Wert-Paare innerhalb des Starttags eines Elements handelt. Im folgenden Beispiel werden zwei Attribute (version und href) für das <codeBase> Element angegeben, das angibt, wo die Laufzeit eine Assembly finden kann (weitere Informationen finden Sie unter Angeben des Speicherorts einer Assembly).

<codeBase version="2.0.0.0"
          href="http://www.litwareinc.com/myAssembly.dll"/>

Computerkonfigurationsdateien

Die Computerkonfigurationsdatei Machine.configenthält Einstellungen, die auf einen ganzen Computer angewendet werden. Diese Datei befindet sich im %Laufzeitinstallationspfad%\Config-Verzeichnis. Machine.config enthält Konfigurationseinstellungen für computerweite Assemblybindung, integrierte Remotingkanäle und ASP.NET.

Das Konfigurationssystem sucht zunächst in der Computerkonfigurationsdatei nach dem <appSettings-Element> und anderen Konfigurationsabschnitten, die ein Entwickler definieren kann. Anschließend wird in der Anwendungskonfigurationsdatei nachschaut. Damit die Computerkonfigurationsdatei verwaltbar bleibt, empfiehlt es sich, diese Einstellungen in die Anwendungskonfigurationsdatei zu setzen. Wenn Sie die Einstellungen jedoch in die Computerkonfigurationsdatei einfügen, kann ihr System besser verwaltet werden. Wenn Sie beispielsweise über eine Drittanbieterkomponente verfügen, die sowohl Ihre Client- als auch die Serveranwendung verwendet, ist es einfacher, die Einstellungen für diese Komponente an einer zentralen Stelle zu platzieren. In diesem Fall ist die Computerkonfigurationsdatei der richtige Ort für die Einstellungen, sodass Sie nicht über die gleichen Einstellungen in zwei verschiedenen Dateien verfügen.

Hinweis

Durch die Bereitstellung einer Anwendung mit XCOPY werden die Einstellungen in der Computerkonfigurationsdatei nicht kopiert.

Weitere Informationen dazu, wie die Common Language Runtime die Computerkonfigurationsdatei für die Assemblybindung verwendet, finden Sie unter How the Runtime Locates Assemblies.

Anwendungskonfigurationsdateien

Eine Anwendungskonfigurationsdatei enthält Einstellungen, die für eine App spezifisch sind. Diese Datei enthält Konfigurationseinstellungen, die von der Common Language Runtime gelesen werden (z. B. Assemblybindungsrichtlinie, Remotingobjekte usw.), sowie Einstellungen, die die App lesen kann.

Der Name und der Speicherort der Anwendungskonfigurationsdatei hängen vom Host der App ab. Dies kann eine der folgenden Sein:

  • Ausführbare, gehostete App.

    Diese Apps verfügen über zwei Konfigurationsdateien: eine Quellkonfigurationsdatei, die während der Entwicklung vom Entwickler geändert wird, und eine Ausgabedatei, die mit der App verteilt wird.

    Standardmäßig ist der Name der Quellkonfigurationsdatei App.config. Wenn Sie ein .NET Framework-Projekt in Visual Studio erstellen, wird dem Projekt automatisch eine App.config Datei hinzugefügt. Sie können eine Datei auch manuell hinzufügen, indem Sie ">Neue Datei" auswählen. Platzieren Sie die App.config-Datei im Projektverzeichnis, und legen Sie die Eigenschaft In Ausgabeverzeichnis kopieren auf Immer kopieren oder Kopieren, falls neu fest.

    Um die Ausgabekonfigurationsdatei zu erstellen, die mit der App bereitgestellt wird, kopiert Visual Studio die Quellkonfigurationsdatei in das Verzeichnis, in dem die kompilierte Assembly platziert wird. Diese Datei hat den Namen <"yourappname> ".exe.config. Beispielsweise verfügt eine App mit dem Namen myApp.exe über eine Ausgabekonfigurationsdatei mit dem Namen myApp.exe.config.

    In einigen Fällen kann Visual Studio die Ausgabekonfigurationsdatei ändern. Weitere Informationen finden Sie unter Umleitungsversionen auf App-Ebene.

  • Von ASP.NET gehostete App.

    Weitere Informationen zu ASP.NET Konfigurationsdateien finden Sie unter ASP.NET Konfigurationseinstellungen.

Sicherheitskonfigurationsdateien

Sicherheitskonfigurationsdateien enthalten Informationen zur Codegruppenhierarchie und Berechtigungssätze, die einer Richtlinienstufe zugeordnet sind. Es wird dringend empfohlen, das Code Access Security Policy-Tool (Caspol.exe) zu verwenden, um die Sicherheitsrichtlinie zu ändern, um sicherzustellen, dass Richtlinienänderungen die Sicherheitskonfigurationsdateien nicht beschädigen.

Hinweis

Ab .NET Framework 4 sind die Sicherheitskonfigurationsdateien nur vorhanden, wenn die Sicherheitsrichtlinie geändert wurde.

Die Sicherheitskonfigurationsdateien befinden sich an den folgenden Speicherorten:

  • Konfigurationsdatei für Unternehmensrichtlinien: %Laufzeitinstallationspfad%\Config\Enterprisesec.config

  • Computerrichtlinienkonfigurationsdatei: %Laufzeitinstallationspfad%\Config\Security.config

  • Konfigurationsdatei für Benutzerrichtlinien: %USERPROFILE%\Anwendungsdaten\Microsoft\CLR-Sicherheitskonfiguration\vxx.xx\Security.config

Siehe auch