Správa odkazů v projektu
Než začnete psát kód proti externí komponentě nebo připojené službě, musí projekt nejprve obsahovat odkaz na ni. Odkaz je v podstatě položka v souboru projektu, který obsahuje informace, které Visual Studio potřebuje k vyhledání komponenty nebo služby.
Způsob přidání odkazu závisí na typu projektu pro kód, na kterém pracujete:
Pokud se v Průzkumníku řešení zobrazí uzel Závislosti, můžete pomocí místní nabídky po kliknutí pravým tlačítkem vybrat Přidat referenci projektu.
Pokud se v Průzkumníku řešenízobrazí uzel Referencí, můžete pomocí místní nabídky po kliknutí pravým tlačítkem vybrat Přidat referenci.
Další informace naleznete v tématu Jak na to: Přidání nebo odebrání odkazů.
Můžete přidat odkaz na následující typy komponent a služeb:
Knihovny tříd nebo sestavení .NET
Aplikace pro UPW
Komponenty modelu COM
Ostatní sestavení nebo třídní knihovny projektů ve stejném řešení
Sdílené projekty
Webové služby XML
Odkazy na aplikace pro UPW
Platforma univerzálních aplikací Windows (UWP) poskytuje společnou aplikační platformu pro každé zařízení, které používá Windows. Informace o vytvoření aplikace pro UPW najdete v tématu Kurz: Vytvoření první aplikace pro univerzální platformu Windows v sadě Visual Studio pomocíXAML a C#.
Odkazy na projekt
Projekty univerzální platformy Windows (UPW) můžou vytvářet odkazy na jiné projekty UPW v řešení nebo na projekty windows 8.1 nebo binární soubory za předpokladu, že tyto projekty nepoužívají rozhraní API, která jsou ve Windows 10 a novějších zastaralá. Další informace naleznete v tématu Přesunutí z Windows Runtime 8 do UWP.
Pokud se rozhodnete převést projekty Windows 8.1 na Windows 10 a novější, přečtěte si téma Port, migrace a upgrade projektů sady Visual Studio.
Spropitné
Informace o tom, jak vytvořit a vytvořit novou aplikaci pro UPW pro Windows 10 a Windows 11, najdete v tématu Volba verze UPW.
Referenční informace k sadě SDK rozšíření
Aplikace Visual Basic, C#, C++ a JavaScript Universal Windows Platform (UPW) můžou odkazovat na sady SDK rozšíření, které cílí na Windows 8.1, pokud tyto sady SDK rozšíření nepoužívají rozhraní API, která jsou v systému Windows 10 a novějších zastaralá. Podívejte se na web dodavatele sady SDK rozšíření a zjistěte, jestli na ni můžou odkazovat aplikace upW.
Pokud zjistíte, že sada SDK rozšíření, na kterou vaše aplikace odkazuje, není podporovaná, musíte provést následující kroky:
Prohlédněte si název projektu, který způsobuje chybu. Platforma, na kterou cílí váš projekt, je uvedena v závorkách vedle názvu projektu. Například MyProjectName (Windows 8.1) znamená, že projekt Název_projektu cílí na platformu verze 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 váš projekt cílí.
Poznámka
Jedním ze způsobů, jak zjistit, zda má sada SDK rozšíření závislosti na jiných sadách SDK rozšíření, je podívat se do správce odkazů. Restartujte Visual Studio, vytvořte nový projekt aplikace pro UWP v jazyce C#, a potom klikněte pravým tlačítkem myši na projekt a vyberte Přidat referenci. Přejděte na kartu Windows, potom na dílčí kartu Rozšíření a vyberte SDK rozšíření. Podívejte se v pravém podokně ve správci odkazů Reference Manager. Pokud obsahuje závislosti, zobrazí se tam.
Důležitý
Pokud váš projekt cílí konkrétně na Windows 10 a sada SDK rozšíření nainstalovaná v předchozím kroku je závislá na balíčku modulu runtime Microsoft Visual C++, verze balíčku modulu runtime Microsoft Visual C++, která je kompatibilní s Windows 10, je v14.0 a je nainstalovaná se sadou Visual Studio.
Pokud sada SDK rozšíření, kterou jste nainstalovali v předchozím kroku, obsahuje závislosti na jiných sadách SDK rozšíření, přejděte na lokality dodavatelů, kteří vlastní závislosti, a pak nainstalujte verze těchto závislostí, které jsou kompatibilní s verzí platformy, na kterou váš projekt cílí.
Restartujte Visual Studio a otevřete aplikaci.
Klikněte pravým tlačítkem myši na uzel Reference nebo Závislosti v projektu, který způsobil chybu, a pak vyberte Přidat odkaz.
Vyberte kartu Windows a poté podkartu Rozšíření. Nejprve zrušte zaškrtnutí políček u starých sad SDK, poté zaškrtněte políčka u nových sad SDK. Vyberte OK.
Přidejte odkaz v době návrhu
Když v projektu vytvoříte odkaz na sestavení, Visual Studio vyhledá sestavení v následujících umístěních:
Aktuální adresář projektu. (Tato sestavení najdete pomocí záložky Procházet.)
Ostatní adresáře projektů ve stejném řešení. Tato sestavení najdete na kartě Projekty.
Poznámka
- Všechny projekty obsahují implicitní odkaz na mscorlib.
- Všechny projekty obsahují implicitní odkaz na
System.Core, a to i v případě, žeSystem.Coreje odebrán ze seznamu odkazů. - Projekty jazyka Visual Basic obsahují implicitní odkaz na Microsoft.VisualBasic.
Odkazy na sdílené komponenty během běhu programů
V době běhu musí být komponenty buď ve výstupní cestě projektu, nebo v globální mezipaměti sestavení (GAC). Pokud projekt obsahuje odkaz na objekt, který není v jednom z těchto umístění, musíte při sestavení projektu zkopírovat odkaz na výstupní cestu projektu. Vlastnost CopyLocal označuje, zda se má tato kopie vytvořit. Pokud je hodnota True, při sestavení projektu se odkaz zkopíruje do adresáře projektu. Pokud je hodnota false, odkaz se nezkopíruje.
Pokud nasadíte aplikaci, která obsahuje odkaz na vlastní komponentu zaregistrovanou v GAC, komponenta se s aplikací nenasadí bez ohledu na nastavení CopyLocal. V dřívějších verzích sady Visual Studio jste mohli nastavit vlastnost CopyLocal odkazu, abyste zajistili, že bylo sestavení nasazeno. Nyní musíte ručně přidat sestavení do složky \Bin. Tato akce umístí veškerý vlastní kód pod kontrolu, čímž se sníží riziko publikování vlastního kódu, se kterým nejste obeznámeni.
Ve výchozím nastavení je vlastnost CopyLocal nastavena na False, pokud je sestavení nebo součást v globální mezipaměti sestavení nebo je součástí architektury. V opačném případě je hodnota nastavena na hodnotu True. Odkazy mezi projekty jsou vždy nastaveny na True.
Odkazování na projekt nebo sestavení, které cílí na jinou verzi .NET
Můžete vytvořit aplikace, které odkazují na projekty nebo sestavení, které cílí na jinou verzi rozhraní .NET. Můžete například vytvořit aplikaci, která cílí na rozhraní .NET Framework 4.6, která odkazuje na sestavení, které cílí na rozhraní .NET Framework 4.5. Pokud vytvoříte projekt, který cílí na starší verzi .NET, nemůžete v tomto projektu nastavit odkaz na projekt nebo sestavení, které cílí na novější verzi.
Další informace naleznete v přehledu cílení rámce .
Odkazy mezi projekty
Odkazy mezi projekty jsou odkazy na projekty, které zahrnují sestavení; přidáte odkazy na projekty pomocí karty Projekty dialogového okna Správce odkazů. Visual Studio může najít sestavení, pokud je zadána cesta k projektu.
Pokud máte projekt, který vytváří sestavení, měli byste na projekt odkazovat a nepoužívat odkaz na soubor. Výhodou odkazu z projektu na projekt je, že v systému sestavení vytváří závislosti mezi projekty. Závislý projekt se sestaví, pokud se změnil od doby, kdy byl naposledy sestaven odkazující projekt. Odkaz na soubor nevytvoří závislost sestavení, takže je možné vytvořit odkazující projekt bez sestavení závislého projektu a odkaz může být zastaralý. (To znamená, že projekt může odkazovat na dříve vytvořenou verzi projektu.) To může mít za následek, že by v adresáři bin bylo potřeba více verzí jedné knihovny DLL, což není možné. Když dojde ke konfliktu, zobrazí se zpráva, například: "Upozornění: závislost 'soubor' v projektu 'project' nelze zkopírovat do adresáře spuštění, protože by přepsala odkaz 'soubor'." Další informace najdete v tématu Řešení potíží s poškozenými odkazy a Postupy: Vytvoření a odebrání závislostí projektu.
Poznámka
Pokud cílová verze rozhraní .NET Framework jednoho projektu je verze 4.5 a cílová verze druhého projektu je verze 2, 3, 3, 3.5 nebo 4.0, vytvoří se odkaz na soubor místo odkazu na projekt.
Sdílené odkazy na projekt
Na rozdíl od většiny ostatních typů projektů sdílený projekt nemá žádný binární výstup. Místo toho se kód zkompiluje do každého projektu, který na něj odkazuje. Sdílené projekty umožňují napsat běžný kód, na který odkazuje mnoho různých projektů aplikací. Kód je zkompilován jako součást každého odkazujícího projektu a může obsahovat direktivy kompilátoru, které pomáhají začlenit funkce specifické pro platformu do sdíleného základu kódu. Přidejte odkaz na sdílený projekt na kartě Sdílené projekty v dialogovém okně Správce odkazů.
Odkazy na soubory
Reference na soubory jsou přímé odkazy na sestavení mimo kontext projektu sady Visual Studio. Vytvoříte je pomocí záložky Procházet v dialogovém okně Správce odkazů. Odkaz na soubor použijte, pokud máte pouze sestavení nebo komponentu, a ne projekt, který ho vytvoří jako výstup.