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

Článek
03/05/2024

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.
Prostředky / -resource: Vložte zadaný prostředek (krátký formulář: /res).
LinkResources / -linkresources: Propojte zadaný prostředek s tímto sestavením.

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é by pomohly identifikovat vaši aplikaci v Průzkumník 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ík souborů.

<Win32Icon>filename</Win32Icon>

filenameje .ico soubor, který chcete přidat do výstupního souboru. Soubor .ico lze 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ý se má 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. Kompilátor jazyka C# ve výchozím nastavení vloží manifest aplikace, který určuje požadovanou úroveň spuštění "asInvoker". Vytvoří manifest ve stejné složce, ve které je spustitelný soubor sestaven. Pokud chcete zadat vlastní manifest, například zadat požadovanou úroveň spuštění "highestAvailable" nebo "require Správa istrator", použijte tuto možnost k zadání názvu souboru.

Poznámka:

Tato možnost a možnost Win32Resources 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í, bude podléhat virtualizaci souborů a registru v rámci funkce Řízení uživatelských účtů ve Windows. Další informace najdete v tématu Řízení uživatelských účtů.

Vaše aplikace bude podléhat 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 />

Při použití této možnosti bude aplikace podléhat virtualizaci v systému Windows Vista, pokud nezadáte manifest aplikace v souboru prostředků Win32 nebo v pozdějším kroku sestavení.

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#).

Zdroje informací

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

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

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ý se používá 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 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á přístupnost než public nebo private není povolená. Pokud filename je soubor prostředků .NET vytvořený například Resgen.exe nebo ve vývojovém prostředí, je přístupný se členy 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í zdrojů ve výstupním souboru je určeno z pořadí zadaného v souboru projektu.

LinkResources

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

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

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ý se používá 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 vytvoření pomocí kompilátoru jazyka C#. Pokud chcete, aby byly prostředky soukromé, zadejte private jako modifikátor přístupnosti. Jiný modifikátor public než nebo private není povolen. Pokud filename je soubor prostředků .NET vytvořený například Resgen.exe nebo ve vývojovém prostředí, je přístupný se členy 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í knihovnu DLL součást sestavení, aby ji bylo možné 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í.