/resource (C#-Compileroptionen)

Bettet die angegebene Ressource in die Ausgabedatei ein.

Syntax

/resource:filename[,identifier[,accessibility-modifier]]  

Argumente

filename
Die .NET Framework-Ressourcendatei, die in die Ausgabedatei eingebettet werden soll.

identifier (optional)
Der logische Name der Ressource. Der Name, mit dem die Ressource geladen wird. Der Standardwert ist der Name der Datei.

accessibility-modifier (optional)
Barrierefreiheit der Ressource: öffentlich oder privat. Der Standardwert ist „öffentlich“.

Hinweise

Verwenden Sie /linkresource, um eine Ressource mit einer Assembly zu verknüpfen, anstatt die Ressourcendatei zur Ausgabedatei hinzuzufügen.

Ressourcen sind standardmäßig in der Assembly öffentlich, wenn sie mithilfe des C#-Compilers erstellt werden. Geben Sie private als Modifizierer der Barrierefreiheit an. Außer public und private sind keine anderen Zugriffsmethoden zulässig.

Wenn es sich bei filename um eine .NET Framework-Ressourcendatei handelt, die beispielsweise von resgen.exe oder in der Entwicklungsumgebung erstellt wurde, ist der Zugriff mit Membern im <xref:System.Resources>-Namespace möglich. Weitere Informationen finden Sie unter <xref:System.Resources.ResourceManager?displayProperty=fullName>. Verwenden Sie für alle anderen Ressourcen die GetManifestResource*-Methoden in der <xref:System.Reflection.Assembly>-Klasse, um zur Laufzeit auf die Ressource zuzugreifen.

/res ist die Kurzform von /resource (Ressource).

Die Reihenfolge der Ressourcen in der Ausgabedatei wird durch die in der Befehlszeile angegebene Reihenfolge bestimmt.

So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest

  1. Fügen Sie Ihrem Projekt eine Ressourcendatei hinzu.

  2. Wählen Sie im Projektmappen-Explorer die Datei aus, die Sie einbetten möchten.

  3. Wählen Sie im Fenster Eigenschaften die Option Buildvorgang für die Datei aus.

  4. Legen Sie die Option Buildvorgang auf Eingebettete Ressource fest.

Informationen zum programmgesteuerten Festlegen dieser Compileroption finden Sie unter <xref:VSLangProj80.FileProperties2.BuildAction%2A>.

Beispiel

Kompilieren Sie in.cs, und fügen Sie die Ressourcendatei rf.resource an:

csc /resource:rf.resource in.cs  

Siehe auch

C#-Compileroptionen
Verwalten von Projekt- und Projektmappeneigenschaften