Možnosti kompilátoru jazyka C#, které určují prostředky

Následující možnosti určují, jak kompilátor jazyka C# vytváří nebo importuje prostředky Win32. Nová syntaxe nástroje MSBuild je zobrazena tučně. Starší syntaxe csc.exe je zobrazena v code stylesouboru .

• Win32Resource / -win32res: Zadejte soubor prostředků Win32 (.res).
• Win32Icon / -win32icon: Odkazovat metadata ze zadaného souboru sestavení nebo souborů.
• Win32Manifest / -win32manifest: Zadejte soubor manifestu Win32 (.xml).
• NoWin32Manifest / -nowin32manifest: Nezahrnujte výchozí manifest Win32.
• EmbeddedResource / -resource: Vložte zadaný prostředek (krátký formulář: /res).
• LinkResource / -linkresource: Propojte zadaný prostředek s tímto sestavením.

Poznámka:

Další informace o konfiguraci těchto možností pro váš projekt naleznete v tématu Možnosti kompilátoru.

Win32Resource

Možnost Win32Resource vloží prostředek Win32 do výstupního souboru.

<Win32Resource>filename</Win32Resource>

filename je soubor prostředků, který chcete přidat do výstupního souboru. Prostředek Win32 může obsahovat informace o verzi nebo rastru (ikonách), které pomáhají identifikovat vaši aplikaci v Průzkumníku souborů. Pokud tuto možnost nezadáte, kompilátor vygeneruje informace o verzi na základě verze sestavení.

Win32Icon

Možnost Win32Icon vloží do výstupního souboru .ico soubor, který dává výstupnímu souboru požadovaný vzhled v Průzkumníku souborů.

<Win32Icon>filename</Win32Icon>

filenameje .ico soubor, který chcete přidat do výstupního souboru. Soubor .ico můžete vytvořit pomocí kompilátoru prostředků. Kompilátor prostředků se vyvolá při kompilaci programu Visual C++. Soubor .ico se vytvoří ze souboru .rc .

Win32Manifest

Pomocí možnosti Win32Manifest určete soubor manifestu aplikace Win32 definovaný uživatelem, který chcete vložit do přenosného spustitelného souboru projektu (PE).

<Win32Manifest>filename</Win32Manifest>

filename je název a umístění vlastního souboru manifestu. Ve výchozím nastavení kompilátor jazyka C# vloží manifest aplikace, který určuje požadovanou úroveň asInvokerprovádění . Vytvoří manifest ve stejné složce, ve které je sestaven spustitelný soubor. Pokud chcete zadat vlastní manifest, například zadat požadovanou úroveň highestAvailable spuštění nebo requireAdministrator, použijte tuto možnost k zadání názvu souboru.

Poznámka:

Možnost Win32Manifest a možnost Win32Resource se vzájemně vylučují. Pokud se pokusíte použít obě možnosti na stejném příkazovém řádku, zobrazí se chyba sestavení.

Aplikace, která nemá žádný manifest aplikace, který určuje požadovanou úroveň spuštění, podléhá virtualizaci souborů a registru v rámci funkce Řízení uživatelských účtů v Windows. Další informace najdete v tématu Řízení uživatelských účtů.

Vaše aplikace podléhá virtualizaci, pokud platí některé z těchto podmínek:

• Použijete možnost NoWin32Manifest a v pozdějším kroku sestavení ani jako součást souboru prostředku Systému Windows (.res) nepoužíváte manifest pomocí možnosti Win32Resource .
• Zadáte vlastní manifest, který neurčí požadovanou úroveň spuštění.

Visual Studio vytvoří výchozí soubor .manifest a uloží ho do adresářů ladění a vydaných verzí společně se spustitelným souborem. Vlastní manifest můžete přidat tak, že ho vytvoříte v libovolném textovém editoru a pak ho přidáte do projektu. Nebo můžete kliknout pravým tlačítkem myši na ikonu Projektu v Průzkumník řešení, vybrat Přidat novou položku a pak vybrat Soubor manifestu aplikace. Po přidání nového nebo existujícího souboru manifestu se zobrazí v rozevíracím seznamu Manifest . Další informace najdete v tématu Stránka aplikace, Návrhář projektu (C#).

Manifest aplikace můžete zadat jako vlastní krok po sestavení nebo jako součást souboru prostředků Win32 pomocí možnosti NoWin32Manifest . Tuto stejnou možnost použijte, pokud chcete, aby vaše aplikace podléhala virtualizaci souborů nebo registru v systému Windows Vista.

NoWin32Manifest

Pomocí možnosti NoWin32Manifest instruujte kompilátoru, aby do spustitelného souboru nevložil žádný manifest aplikace.

<NoWin32Manifest />

Pokud použijete tuto možnost, aplikace podléhá virtualizaci na Windows Vista, pokud v souboru prostředků Win32 nebo v pozdějším kroku sestavení nezadáte manifest aplikace.

V sadě Visual Studio nastavte tuto možnost na stránce Vlastností aplikace výběrem možnosti Vytvořit aplikaci bez manifestu v rozevíracím seznamu Manifest . Další informace najdete v tématu Stránka aplikace, Návrhář projektu (C#).

EmbeddedResource

Vloží zadaný prostředek do výstupního souboru.

<EmbeddedResource Include="filename">
  <LogicalName>identifier</LogicalName>
  <Access>accessibility-modifier</Access>
</EmbeddedResource>

filename je soubor prostředků .NET, který chcete vložit do výstupního souboru. identifier (volitelné) je logický název prostředku: název, který používáte k načtení prostředku. Výchozí hodnota je název souboru. accessibility-modifier (volitelné) je přístupnost zdroje: veřejné nebo soukromé. Výchozí hodnota je veřejná. Prostředky jsou ve výchozím nastavení veřejné v sestavení při jejich vytváření pomocí kompilátoru jazyka C#. Pokud chcete, aby byly prostředky soukromé, zadejte private jako modifikátor přístupnosti. Není povolená žádná jiná přístupnost. Pokud filename je soubor prostředků vytvořený .NET, například Resgen.exe nebo ve vývojovém prostředí, můžete k němu přistupovat pomocí členů v System.Resources oboru názvů. Další informace najdete na webu System.Resources.ResourceManager. Pro všechny ostatní prostředky použijte GetManifestResource metody ve Assembly třídě pro přístup k prostředku za běhu. Pořadí prostředků ve výstupním souboru pochází z pořadí zadaného v souboru projektu.

LinkResource

Vytvoří odkaz na prostředek .NET ve výstupním souboru. Soubor prostředků se do výstupního souboru nepřidá. LinkResource se liší od možnosti EmbeddedResource , která vkládá soubor prostředků do výstupního souboru.

<LinkResource Include="filename">
  <LogicalName>identifier</LogicalName>
  <Access>accessibility-modifier</Access>
</LinkResource>

filename je soubor prostředků .NET, ke kterému chcete vytvořit propojení ze sestavení. identifier (volitelné) je logický název prostředku: název, který používáte k načtení prostředku. Výchozí hodnota je název souboru. accessibility-modifier (volitelné) je přístupnost zdroje: veřejné nebo soukromé. Výchozí hodnota je veřejná. Ve výchozím nastavení jsou propojené prostředky veřejné v sestavení při jejich vytváření pomocí kompilátoru jazyka C#. Pokud chcete, aby byly prostředky soukromé, zadejte private jako modifikátor přístupnosti. Není povolen žádný jiný modifikátor. Pokud filename je soubor prostředků vytvořený .NET, například Resgen.exe nebo ve vývojovém prostředí, můžete k němu přistupovat pomocí členů v System.Resources oboru názvů. Další informace najdete na webu System.Resources.ResourceManager. Pro všechny ostatní prostředky použijte GetManifestResource metody ve Assembly třídě pro přístup k prostředku za běhu. Soubor zadaný v filename libovolném formátu. Můžete například chtít vytvořit nativní část sestavení DLL, aby bylo možné ji nainstalovat do globální mezipaměti sestavení a přistupovat ke spravovanému kódu v sestavení. Totéž můžete udělat v linkeru sestavení. Další informace najdete v tématu Al.exe (linker sestavení) a práce se sestaveními a globální mezipamětí sestavení.