/linkresource (Možnosti C# kompilátoru)

Vytvoří vazbu na prostředek rozhraní .NET Framework ve výstupním souboru. Soubor prostředků není do výstupního souboru přidán. Liší se od možnosti /resource, která vkládá soubor prostředků do výstupního souboru.

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

Argumenty

  • filename
    Soubor prostředků rozhraní .NET Framework, se kterým chcete propojit dané sestavení.

  • identifier (volitelné)
    Logický název pro prostředek; název, který je použit k načtení prostředku. Výchozí hodnota je název daného souboru.

  • accessibility-modifier (volitelné)
    Přístupnost prostředku: veřejné nebo soukromé. Výchozí hodnota je veřejné.

Poznámky

Ve výchozím nastavení jsou propojené prostředky, při vytváření pomocí kompilátoru jazyka C#, v daném sestavení veřejné. Chcete-li změnit prostředky na soukromé, zadejte private jako modifikátor dostupnosti. Žádný jiný modifikátor kromě public nebo private není povolen.

/linkresource vyžaduje jednu z možností /target kromě /target:module.

Pokud je filename soubor prostředků rozhraní .NET Framework, vytvořený například pomocí Resgen.exe nebo ve vývojovém prostředí, lze k němu přistupovat pomocí členů v oboru názvů System.Resources. Další informace naleznete v tématu System.Resources.ResourceManager. Pro přístup ke všem ostatním prostředkům v době běhu použijte GetManifestResource* metody ve třídě Assembly.

Soubor určený pomocí filename může být libovolného formátu. Například můžete chtít, aby se nativní knihovna DLL stala součástí sestavení tak, aby mohla být nainstalována do globální mezipaměti sestavení (GAC) a mohlo k ní být v sestavení přistupováno ze spravovaného kódu. Druhý z následujících příkladů ukazuje jak toto provést. Stejnou činnost můžete provést v propojovacím programu sestavení. Třetí z následujících příkladů ukazuje jak toto provést. Další informace naleznete v tématu Al.exe (Assembly Linker) a Práce se sestaveními a globální mezipamětí sestavení (GAC).

/linkres je zkratka pro /linkresource.

Tato možnost kompilátoru není dostupná v aplikaci Visual Studio a nemůže být změněna programově.

Příklad

Zkompiluje in.cs a propojte se souborem prostředků rf.resource:

csc /linkresource:rf.resource in.cs

Zkompiluje A.cs do knihovny DLL, propojí tuto knihovnu s nativní DLL knihovnou N.dll a umístí výstup do globální mezipaměti sestavení (GAC). V tomto příkladu jak A.dll tak i N.dll budou umístěny v globální mezipaměť sestavení (GAC).

csc /linkresource:N.dll /t:library A.cs
gacutil -i A.dll

Tento příklad provede totéž jako předchozí, ale pomocí možností propojovacího programu sestavení.

csc /t:module A.cs
al /out:A.dll A.netmodule /link:N.dll 
gacutil -i A.dll

Viz také

Odkaz

Al.exe (Assembly Linker)

Další zdroje

Možnosti C# kompilátoru

Práce se sestaveními a globální mezipamětí sestavení (GAC)

Vlastnosti projektu (Visual Studio)