Odkazy na projekt

Článek
08/11/2011

Chcete-li zapsat kód proti externí komponentě, váš projekt na ni musí nejprve obsahovat odkaz. Můžete vytvořit odkaz na následující typy komponent:

Knihovny tříd rozhraní .NET framework nebo sestavení
COM komponenty
Jiné sestavení nebo knihovny tříd projektů ve stejném řešení
Webové služby XML

Další informace o odkazech webové služby XML naleznete v tématu Webové reference v sadě Visual Studio.

Přidání odkazů za doby návrhu

Použijte dialogové okno Přidat odkaz k přidání odkazů na komponenty za doby návrhu.

Můžete použít dialogové okno Přidat odkaz k přejití na sestavení, které nejsou uvedeny. Nelze přidat odkazy z Globální mezipaměť sestavení (GAC) globální mezipaměti sestavení (GAC), protože je nezbytnou součástí prostředí za běhu.

Pokud vytvoříte odkaz ve vašem projektu na sestavení, Visual Studio vyhledá sestavení v následujících umístěních:

Aktuální adresář projektu. (Můžete vyhledat tyto sestavení pomocí karty Procházet.)
Další adresáře projektu ve stejném řešení. (Tyto sestavení můžete najít na kartě Projekty.)

Další informace o tom, jak přidat odkazy v době návrhu, naleznete v tématu Postupy: Přidat nebo odebrat odkazy v sadě Visual Studio.

Poznámka

Všechny projekty obsahují implicitní odkaz na mscorlib. Projekty jazyka Visual Basic obsahují implicitní odkaz na Microsoft.VisualBasic.

V sadě Visual Studio 2010 všechny projekty obsahují implicitní odkaz na System.Core, i když je System.Core odebrán ze seznamu odkazů.

Odkazy na sdílené komponenty za běhu

Za běhu musí být komponenty v cestě výstupu projektu nebo v Globální mezipaměť sestavení (GAC) (globální mezipaměť sestavení (GAC)). Pokud projekt obsahuje odkaz na objekt, který není v jednom z těchto umístění, musíte zkopírovat odkaz na výstupní cestu k projektu při sestavení projektu. Vlastnost CopyLocal označuje, zda tato kopie má být provedena. Pokud je hodnota True, odkaz je zkopírován do adresáře projektu při vytváření projektu. Pokud je hodnota False, odkaz není kopírován.

Pokud nasadíte aplikaci, která obsahuje odkaz na vlastní komponentu registrovanou v globální mezipaměti sestavení (GAC), komponenta nebude nasazena s aplikací bez ohledu na nastavení CopyLocal. V dřívějších verzích Visual Studio jste mohli nastavit vlastnost CopyLocal na odkaz k zajištění toho, že bylo sestavení nasazeno. Nyní je třeba ručně přidat sestavení do složky \Bin. To umístí všechny vlastní kódy pod kontrolu, což zmenší riziko publikování vlastního kódu, se kterým nejste obeznámeni.

Ve výchozím nastavení je vlastnost CopyLocal nastavena na hodnotu False, pokud sestavení nebo komponenta je v globální mezipaměti sestavení (GAC) nebo je komponenta architektury. V opačném případě je hodnota nastavena na True. Odkazy typu projekt-projekt jsou vždy nastaveny na hodnotu True.

Odkazování na projekt nebo sestavení, které má různou verzi platformy .NET Framework

Je možné vytvořit aplikace, které odkazují na projekty nebo sestavení, pro které je jiná cílová verze rozhraní .NET Framework. Například můžete vytvořit aplikaci, která se zaměřuje na .NET Framework 4 Client Profile, který odkazuje na sestavení, který se zaměřuje na .NET Framework verze 2.0. Pokud jste vytvořili projekt, který se zaměřuje na starší verzi .NET Framework, nemůžete nastavit odkaz v daném projektu na projekt nebo sestavení, které se zaměřuje na .NET Framework 4 Client Profile nebo rozhraní .NET Framework verze 4.

Další informace naleznete v tématu Zaměření na specifickou verzi rozhraní .NET Framework nebo profilu.

Odkazy typu projekt-projekt a odkazy na soubory

Odkazy na soubory jsou přímé odkazy na sestavení; vytvoříte je pomocí karty Procházet v dialogovém okně Přidat odkaz. Odkazy typu projekt-projekt jsou odkazy na projekty obsahující sestavení; vytvoříte je pomocí karty Projekt v dialogovém okně Přidat odkaz.

Výhodou odkazu typu projekt-projekt je to, že vytvoří závislost mezi projekty v systému sestavení. Závislý projekt tedy bude vytvořen, jestliže se změnil od posledního vytvoření odkazujícího projektu. Odkaz na soubor nevytváří závislost sestavení, takže je možné sestavit odkazující projekt bez vytváření závislého projektu a odkaz se může stát zastaralý. (To znamená, že projekt může odkazovat na dřívější sestavené verze projektu.) Výsledkem může být několik požadovaných verzí jednoho souboru knihovny DLL v adresáři bin, což není možné. Dojde-li k tomuto konfliktu, zobrazí se zpráva, například Warning: the dependency 'file' in project 'project' cannot be copied to the run directory because it would overwrite the reference 'file.'.

Měli byste se vyhnout přidávání odkazů na soubor do výstupů jiného projektu ve stejném řešení, protože to může způsobit chyby kompilace. Místo toho použijte kartu Projekty v dialogovém okně Přidat odkaz k vytvoření odkazů typu projekt-projekt ve stejném řešení. Toto usnadňuje vývoj v týmu povolením lepší správy knihoven tříd, které vytvoříte ve svých projektech. Další informace naleznete v tématu Poradce při potížích s poškozenými odkazy a How to: Create and Remove Project Dependencies.

Poznámka

V sadě Visual Studio 2010 je odkaz na soubor místo odkazu na projekt vytvořen, pokud cílová verze rozhraní .NET Framework jednoho projektu je verze 4 a cílová verze jiného projektu je verze 2, 3 nebo 3.5.

Webové odkazy

Webové odkazy můžete také přidat pomocí dialogového okna Přidat webový odkaz. Další informace naleznete v tématu Postupy: Přidání a odebrání webových referencí.