/appconfig (C#-Compileroptionen)/appconfig (C# Compiler Options)

Mit der Compileroption /appconfig kann eine C#-Anwendung den Speicherort der Anwendungskonfigurationsdatei („app.config“) der Assembly für die Common Language Runtime (CLR) zur Assemblybindungszeit festlegen.The /appconfig compiler option enables a C# application to specify the location of an assembly's application configuration (app.config) file to the common language runtime (CLR) at assembly binding time.

SyntaxSyntax

/appconfig:file  

ArgumenteArguments

file
Erforderlich.Required. Die Anwendungskonfigurationsdatei mit den AssemblybindungseinstellungenThe application configuration file that contains assembly binding settings.

HinweiseRemarks

Der Gebrauch von /appconfig ist ein erweitertes Szenario, in dem eine Assembly gleichzeitig auf die Version von .NET Framework und von .NET Framework for Silverlight einer bestimmten Verweisassembly verweisen muss.One use of /appconfig is advanced scenarios in which an assembly has to reference both the .NET Framework version and the .NET Framework for Silverlight version of a particular reference assembly at the same time. Ein in Windows Presentation Foundation (WPF) geschriebener XAML-Designer muss möglicherweise für die Benutzeroberfläche des Designers sowohl auf den WPF-Desktop als auch auf die Teilmenge von WPF, die in Silverlight enthalten ist, verweisen.For example, a XAML designer written in Windows Presentation Foundation (WPF) might have to reference both the WPF Desktop, for the designer's user interface, and the subset of WPF that is included with Silverlight. Dieselbe Designerassembly muss auf beide Assembly zugreifen.The same designer assembly has to access both assemblies. Standardmäßig verursachen die separaten Verweise einen Compilerfehler, da die Assemblybindung die zwei Assemblys als Entsprechung ansieht.By default, the separate references cause a compiler error, because assembly binding sees the two assemblies as equivalent.

Mit der Compileroption /appconfig können Sie den Speicherort einer app.config-Datei festlegen, die das Standardverhalten mit dem <supportPortability>-Tag deaktiviert, wie in folgendem Beispiel gezeigt.The /appconfig compiler option enables you to specify the location of an app.config file that disables the default behavior by using a <supportPortability> tag, as shown in the following example.

<supportPortability PKT="7cec85d7bea7798e" enable="false"/>

Der Compiler übergibt den Speicherort der Datei an die Assemblybindungslogik der CLR.The compiler passes the location of the file to the CLR's assembly-binding logic.

Hinweis

Wenn Sie das Microsoft-Buildmodul (MSBuild) verwenden, um Ihre Anwendung zu erstellen, können Sie die Compileroption /appconfig festlegen, indem Sie ein Eigenschaftentag in die CSPROJ-Datei einfügen.If you are using the Microsoft Build Engine (MSBuild) to build your application, you can set the /appconfig compiler option by adding a property tag to the .csproj file. Fügen Sie den Eigenschaftentag <UseAppConfigForCompiler> in die CSPROJ-Datei ein, und legen Sie dessen Wert auf true fest, um die app.config-Datei zu verwenden, die bereits im Projekt angegeben ist.To use the app.config file that is already set in the project, add property tag <UseAppConfigForCompiler> to the .csproj file and set its value to true. Fügen Sie den Eigenschaftentag <AppConfigForCompiler> in die CSPROJ-Datei ein, und legen Sie dessen Wert auf den Speicherort der Datei fest, um eine andere app.config-Datei anzugeben.To specify a different app.config file, add property tag <AppConfigForCompiler> and set its value to the location of the file.

BeispielExample

In folgendem Beispiel wird eine app.config-Datei gezeigt, die es einer Anwendung ermöglicht, über Verweise sowohl auf die .NET Framework-Implementierung als auch die .NET Framework for Silverlight-Implementierung jeder .NET Framework-Assembly zu verfügen, die in beiden Implementierungen vorhanden ist.The following example shows an app.config file that enables an application to have references to both the .NET Framework implementation and the .NET Framework for Silverlight implementation of any .NET Framework assembly that exists in both implementations. Die Compileroption /appconfig gibt den Speicherort der app.config-Datei an.The /appconfig compiler option specifies the location of this app.config file.

<configuration>  
      <runtime>  
      <assemblyBinding>  
            <supportPortability PKT="7cec85d7bea7798e" enable="false"/>  
            <supportPortability PKT="31bf3856ad364e35" enable="false"/>  
      </assemblyBinding>  
      </runtime>  
</configuration>  

Siehe auchSee Also

<SupportPortability >-Element<supportPortability> Element
C#-Compileroptionen alphabetisch sortiertC# Compiler Options Listed Alphabetically