/reference (Možnosti C# kompilátoru)
/reference Možnost způsobí, že kompilátor import veřejné do zadaného souboru zadejte informace do aktuálního projektu, což umožní odkazovat na metadata ze zadaných souborů sestavení.
/reference:[alias=]filename
/reference:filename
Arguments
filename
Název soubor, který obsahuje manifest sestavení.Chcete-li importovat více než jeden soubor, zadejte možnost /reference pro každý soubor samostatně.alias
Platný identifikátor jazyka C# představující kořenový obor názvů, který bude obsahovat všechny obory názvů v daném sestavení.
Poznámky
Chcete-li importovat z více než jednoho souboru, zadejte možnost /reference pro každý soubor.
Soubory, které importujete, musí obsahovat manifest; musí mít výstupní soubor kompilována s jedním z Target možnosti než /target:module.
/r je zkratka pro /reference.
Použití /addmodule k importu metadat z výstupní soubor, který neobsahuje manifestu sestavení.
Odkazujete-li na sestavení (sestavení A), které odkazuje na jiné sestavení (sestavení B), budete potřebovat odkazovat na sestavení B, pokud:
Použitý typ ze sestavení A dědí z typu nebo implementuje rozhraní ze sestavení B.
Vyvoláte pole, vlastnost, událost nebo metodu, která má návratový typ nebo typ parametru ze sestavení B.
Použití /lib na adresář, ve kterém se nachází jedna nebo více odkazy na sestavení.Téma o /lib také popisuje adresáře, ve kterých kompilátor vyhledává sestavení.
Chcete-li, aby kompilátor rozpoznával typ v sestavení a nikoli v modulu, je zapotřebí ho donutit k přeložení typu, což lze provést definováním instance daného typu.Existují další způsoby řešení názvy typů v sestavení pro kompilátor: například pokud zdědíte z typu v sestavení název typu bude potom rozpoznán kompilátorem.
Někdy je nezbytné odkazovat z jednoho sestavení na dvě různé verze stejné komponenty.Chcete-li toto provést, použijte volbu alias na přepínači /reference pro každý soubor, aby bylo možné dané dva soubory rozlišit.Tento alias bude použit jako kvalifikátor pro název komponenty a bude přidružen ke komponentě v jednom ze souborů.
Soubor odpovědí csc (.rsp), jehož odkazy běžně používají sestavení platformy .NET Framework, je ve výchozím nastavení používán.Použít /noconfig Pokud nechcete použít csc.rsp kompilátoru.
[!POZNÁMKA]
V aplikaci Visual Studio, použít Přidat odkaz na dialogové okno.Další informace naleznete v tématu Jak: Přidat nebo odebrat odkazy pomocí dialogového okna Přidat odkaz.V aplikaci Visual Studio 2010 a novější verze zajistit odpovídající chování mezi přidávání odkazů pomocí /reference a pomocí Přidat odkaz na dialogové okno Vložit Interop typy musí být vlastnost nastavena na False pro sestavení, který přidáváte.True je výchozí hodnota pro tuto vlastnost.
Příklad
Tento příklad ukazuje použití externí alias funkce.
Kompilace zdrojového souboru a importovat metadata z grid.dll a grid20.dll,který byl kompilován dříve.Tyto dvě knihovny obsahují samostatné verze stejné součásti a pro kompilaci zdrojového souboru použijete dvě /reference s možnostmi alias.Dané možnosti mají tento tvar:
/reference:GridV1=grid.dll a /reference:GridV2=grid20.dll
Toto zajistí nastavení externích aliasů "GridV1" a "GridV2", které použijete v program ve formě externího příkazu:
extern alias GridV1;
extern alias GridV2;
// Using statements go here.
Jakmile je toto nastaveno, můžete odkazovat na ovládací prvek grid z grid.dll pomocí prefixu GridV1 před názvem ovládacího prvku následovně:
GridV1::Grid
Navíc můžete odkazovat na ovládací prvek grid z grid20.dll pomocí prefixu GridV2 před názvem ovládacího prvku následujícím způsobem:
GridV2::Grid
Viz také
Úkoly
Jak: Upravte vlastnosti projektu a nastavení konfigurace