Správa odkazů projektu

Článek
05/16/2015

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

Odkazy na aplikace pro Windows Store
Knihovny tříd nebo sestavení rozhraní .NET Framework
Komponenty COM
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 Web References.

Odkazy na aplikace pro Windows Store

Odkazy na projekt

Projekty pro Windows Store, které jsou určeny pro Windows 8, nemohou záviset na projektech pro Windows Store nebo binárních souborech, které jsou určeny pro Windows 8.1.

Pokud se některý projekt na vaší aplikaci zaměřuje na Windows 8.1 a vaše aplikace se skládá z projektu C++ Windows Store, bude nutné provést následující kroky:

Přesměrovat všechny projekty ve vaší aplikaci na systém Windows 8.1.Klepněte pravým tlačítkem myši na jednotlivé projekty ve své aplikaci a vyberte příkaz Přesměrovat na systém Windows 8.1 a klepněte na tlačítko OK v dialogovém okně Přezkoumání projektu a řešení změn.
Klepněte pravým tlačítkem myši na každou aplikaci projektu jazyka Visual Basic, Visual C# a JavaScript, který závisí na projektu C++ ve Windows Store, zvolte možnost Přidat odkaz, přejděte na kartu Windows, podkartu Rozšíření, zrušte zaškrtnutí políčka Microsoft Visual C++ Runtime v11.0 a zaškrtněte Microsoft Visual C++ Runtime Package v12.0, poté klepněte na tlačítko OK.

Projekty Visual Basic, C# a JavaScript Windows Store, které míří na systém Windows 8.1, mohou odkazovat na projekty Visual Basic a C# Windows Store cílené na systém Windows 8 za předpokladu, že tyto projekty nepoužívají rozhraní API, která se již nepoužívají v systému Windows 8.1.Přečtěte si téma Přenesení aplikací Windows 8 do systému Windows 8.1 Preview chcete-li zjistit, zda projekty Windows Store systému Windows 8 se budou i nadále chovat dle očekávání při odkazování z projektu systému Windows 8.1.

Odkazy na rozšíření SDK

Projekty Visual Basic, C#, C++ a JavaScript Windows Store, které cílí na systém Windows 8.1 nesmí odkazovat na rozšíření SDK, která závisí na balíčku Microsoft Visual C++ Runtime Package v11.0, protože to způsobí problémy za běhu.Pokud chcete zjistit, zda sada SDK rozšíření závisí na produktu Microsoft Visual C++ Runtime Package v11.0, vytvořte nový projekt pro Windows Store v jazyce C#, klikněte pravým tlačítkem myši na projekt a vyberte možnost Přidat odkaz, přejděte na kartu Windows, dílčí kartu Rozšíření, vyberte sadu Extension SDK a podívejte se, zda je v pravém podokně Správce odkazů uvedena položka Microsoft.VCLibs, verze = 11.0 jako závislost.

Projekty Visual Basic, C# a JavaScript Windows Store, které cílí na systém Windows 8.1 mohou odkazovat na rozšíření sady SDK, které nezávisí na balíčku Microsoft Visual C++ Runtime Package v11.0, pokud tato rozšíření sady SDK nepoužívají rozhraní API, které se již nepoužívá v systému Windows 8.1.Zkontrolujte web dodavatele rozšíření SDK pro zjištění, zda jej lze odkazovat pomocí projektů Windows Store, které cílí na systém Windows 8.1.

Pokud zjistíte, že není podporováno rozšíření SDK, na které odkazuje vaše aplikace, pak je třeba provést následující kroky:

Podívejte se na název projektu, který je příčinou chyby.Platforma, na kterou projekt míří, je uvedena v závorkách vedle názvu projektu.Například MyProjectName (Windows 8.1) znamená, že projekt MyProjectName je zaměřen na verzi platformy Windows 8.1.

Přejděte na web dodavatele, který vlastní nepodporovanou sadu SDK rozšíření a nainstalujte verzi sady SDK rozšíření se závislostmi, které jsou kompatibilní s verzí platformy, na kterou je projekt zaměřen.

[!POZNÁMKA]

Jedním způsobem, jak zjistit, zda sada rozšíření SDK má závislosti na jiných rozšiřujících sadách SDK, je restartovat aplikaci Visual Studio, vytvořit nový projekt C# Windows Store, kliknout pravým tlačítkem na projekt a vybrat možnost Přidat odkaz, přejít na kartu Windows, přejít na podkartu Rozšíření vybrat sadu rozšíření SDK a podívat se do pravého podokna ve Správci odkazů.Pokud existují závislosti, budou uvedeny zde.

Důležité
Pokud je váš projekt zaměřen na systém Windows 8.1 a v předchozím kroku nainstalované rozšíření SDK obsahuje závislost na balíčku Microsoft Visual C++ Runtime, verze balíčku, který je kompatibilní se systémem Windows 8.1, je v12.0 a je nainstalován společně se sadou Visual Studio 2013.

Pokud rozšíření SDK nainstalované v předchozím kroku obsahuje závislosti na dalších rozšířeních SDK, navštivte weby dodavatelů, kteří závislosti vlastní, a nainstalujte verze těchto závislostí, které jsou kompatibilní s verzí platformy, na kterou je projekt zaměřen.
Restartujte Visual Studio a otevřete aplikaci.
Klepněte pravým tlačítkem myši na projekt, který způsobil chybu a zvolte Přidat odkaz (v projektech Visual Basic, C# nebo JavaScript) nebo Odkazy (v projektech C++).V případě projektů v jazyce C++ klikněte na tlačítko Přidat nový odkaz.
Klikněte na kartu Windows, poté na dílčí kartu Rozšíření, poté zrušte zaškrtnutí políček pro staré SDK rozšíření a nakonec označte pole pro nové SDK rozšíření.Klikněte na tlačítko OK.

Přidání odkazu v době návrhu

Chcete-li přidat v době návrhu jeden nebo více odkazů, můžete použít buď dialogové okno Správce odkazů nebo dialogové okno Přidat odkaz v závislosti na typu projektu, který vytváříte.Použijte dialogové okno Správce odkazů pro všechny aplikace Windows Store a většinu dalších typů projektů.Další informace naleznete v tématu Postupy: Přidání nebo odebrání odkazů pomocí správce odkazů.Několik dalších projektů podporuje dialogové okno Přidat odkaz.Další informace naleznete v tématu Postupy: Přidání nebo odebrání odkazů pomocí dialogového okna Přidat odkaz.

Můžete použít dialogové okno Přidat odkaz k přechodu na sestavení, která nejsou uvedena.Nelze přidat odkazy z Globální mezipaměť sestavení (GAC), protože jde o 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 tato sestavení pomocí karty Procházet.)
Další adresáře projektu ve stejném řešení. (Tato 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řidání nebo odebrání odkazů pomocí dialogového okna Přidat odkaz.

[!POZNÁMKA]

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

Všechny projekty v sadě Visual Studio 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í (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 v odkazu 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 je sestavení nebo komponenta v globální mezipaměti sestavení (GAC) nebo je komponentou 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é cílí různé verze 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 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ým. (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 Upozornění: Závislost 'file' v projektu 'project' nelze zkopírovat do běhového adresáře, protože by přepsala odkaz '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 Řešení potíží s poškozenými odkazy a Postupy: Vytváření a odebrání závislostí projektu.

[!POZNÁMKA]

Odkaz na soubor místo odkazu na projekt je vytvořen, pokud cílová verze rozhraní .NET Framework jednoho projektu je verze 4.5 a cílová verze jiného projektu je verze 2, 3, 3.5 nebo 4.0.

Webové odkazy

Webové odkazy můžete také přidat pomocí dialogového okna Přidat webový odkaz.Další informace naleznete v tématu How to: Add and Remove Web References.

Viz také