Postupy: Přidání nebo odebrání odkazů pomocí správce odkazů
Pomocí dialogového okna Správce odkazů je možné přidávat a upravovat odkazy na součásti, které jste vyvinuli vy, společnost Microsoft nebo jiný vývojář.Pokud vyvíjíte aplikaci pro Windows Store, váš projekt se automaticky odkazuje na všechny sady SDK pro Windows 8 a rozhraní .NET Framework.Pokud vytváříte jiný typ projektu, je nutné přidat tyto odkazy do projektu ručně.
.gif "Poznámka k upozornění") Upozornění |
|---|
Odkazy do jiných typů projektů můžete přidat pomocí dialogového okna Přidat odkaz.Další informace naleznete v tématu Postupy: Přidání nebo odebrání odkazů pomocí dialogového okna Přidat odkaz. |
Přidání a odebrání odkazu
Přidání odkazu do projektu v jazyce C# nebo Visual Basic
Na řádku nabídek vyberte položky Soubor, Otevřít.
Přejděte k řešení nebo projektu.
V Průzkumníku řešení otevřete místní nabídku uzlu projektu a pak zvolte příkaz Přidat odkaz.
Určete odkazy, které chcete přidat, a pak klikněte na tlačítko OK.
Chcete-li odebrat odkaz, otevřete místní nabídku a zvolte příkaz Odebrat.
Přidání odkazu do projektu v jazyce C++
Na řádku nabídek vyberte položky Soubor, Otevřít.
Přejděte k řešení nebo projektu.
V Průzkumníku řešení otevřete místní nabídku uzlu projektu a pak zvolte položku Odkazy.
V dialogovém okně Stránky vlastností klikněte na tlačítko Přidat nový odkaz.
V dialogovém okně Přidat odkaz zadejte odkazy, které chcete přidat, a pak klikněte na tlačítko OK.
Chcete-li odebrat odkaz, otevřete místní nabídku a zvolte příkaz Odebrat.
Otevře se Správce odkazů se seznamem dostupných odkazů seřazených ve skupinách.Typ projektu určuje, které z těchto skupin se zobrazí:
Skupina Sestavení s podskupinami Rozhraní a Rozšíření
Skupina Řešení s podskupinou Projekty
Skupina Windows s podskupinami Jádro a Rozšíření.Odkazy v sadě Windows SDK nebo rozšiřujících sadách SDK můžete prozkoumat pomocí Prohlížeče objektů.
Skupina Procházení s podskupinou Nedávné
Karta Sestavení
Karta Sestavení obsahuje seznam všech sestavení rozhraní. NET Framework, která jsou k dispozici pro odkazování.Karta Sestavení neobsahuje žádná sestavení z globální mezipaměti sestavení (GAC), protože sestavení v GAC jsou součástí běhového prostředí.Pokud nasadíte nebo zkopírujete aplikaci, která obsahuje odkaz na sestavení registrované v GAC, nebude toto sestavení nasazeno nebo zkopírováno spolu s aplikací, a to bez ohledu na nastavení Kopírovat místní.Další informace naleznete v tématu Projektové odkazy.
Pokud ručně přidáte odkaz na jakýkoli obor názvů EnvDTE (EnvDTE, EnvDTE80, EnvDTE90, EnvDTE90a nebo EnvDTE100), nastavte vlastnost Vložit typy spolupráce pro daný odkaz v okně Vlastnosti na hodnotu Nepravda.Nastavení této vlastnosti na hodnotu Pravda může způsobit problémy sestavení z důvodu určitých vlastností EnvDTE, které není možné vložit.
Všechny projekty určené pro klasickou plochu obsahují implicitní odkaz na knihovnu mscorlib.Projekty v jazyce Visual Basic obsahují implicitní odkaz na Microsoft.VisualBasic.V sadě Visual Studio 2012 všechny projekty obsahují implicitní odkaz na System.Core, i když je odebrán ze seznamu odkazů.
Pokud typ projektu nepodporuje skupinu odkazů Sestavení, tato karta se v dialogovém okně Správce odkazů nezobrazí.
Karta Sestavení se skládá ze dvou dílčích karet:
Karta Rozhraní obsahuje všechna sestavení, která tvoří cílené rozhraní.
Inzerovaná sestavení se nacházejí v plné verzi rozhraní a jejich výčet je uveden v seznamu rozhraní, jestliže váš projekt cílí na profil cíleného rozhraní.Inzerovaná sestavení jsou zobrazena šedou barvou z důvodu odlišení od sestavení, která existují v cíleném profilu Rozhraní daného projektu.Pokud například projekt cílí na rozhraní .NET Framework 4 Client, seznam rozhraní obsahuje inzerovaná sestavení z rozhraní .NET Framework 4.Při přidání inzerovaného sestavení je uživatel je upozorněn, že po zavření okna Správce odkazů se změní cílení projektu na rozhraní .NET Framework 4 a bude přidáno dané inzerované sestavení.
Ve výchozím nastavení obsahují projekty aplikací pro Windows Store odkazy na všechna sestavení v cíleném rozhraní Aplikace .NET pro Windows Store už při vytvoření projektu.Uzel jen pro čtení ve složce Odkazy v Průzkumníku řešení ve spravovaných projektech označuje odkaz na celé rozhraní.Proto tedy karta Rozhraní nezobrazí žádná sestavení z rozhraní a namísto toto se zobrazí následující zpráva: „Na všechna sestavení rozhraní je již odkazováno.Pro prozkoumání odkazů rozhraní použijte prohlížeč objektů.“ Pro projekty aplikací pro klasickou plochu karta Rozhraní zobrazuje sestavení z cíleného rozhraní a uživatel musí přidat odkazy, které daná aplikace požaduje.
Karta Rozšíření obsahuje seznam všech sestavení, která vyvinuli externí dodavatelé součástí a ovládacích prvků za účelem rozšíření cíleného rozhraní.Podle účelu dané aplikace mohou být tato sestavení potřebná.
Karta Rozšíření zobrazuje výčet sestavení, která jsou zaregistrována v následujících umístěních:
32-bit machine: HKEY_CURRENT_USER\SOFTWARE\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies] HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies] 64-bit machine: HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies] HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies] And older versions of the [Target Framework Identifier]Pokud je projekt například cílen na rozhraní .NET Framework 4 na 32bitovém počítači, karta Rozšíření bude obsahovat sestavení, která jsou registrována pod klíči \Microsoft\.NETFramework\v4.0\AssemblyFoldersEx\, \Microsoft\.NETFramework\v3.5\AssemblyFoldersEx\, \Microsoft\.NETFramework\v3.0\AssemblyFoldersEx\ a \Microsoft\.NETFramework\v2.0\AssemblyFoldersEx\.
Karta COM
Karta COM obsahuje seznam všech komponent COM, které jsou k dispozici pro odkazování.Pokud chcete přidat odkaz na registrovanou knihovnu DLL modelu COM, která obsahuje vnitřní manifest, nejprve zrušte registraci dané knihovny DLL.V opačném případě sada Visual Studio přidá odkaz na sestavení jako ovládací prvek ActiveX namísto jako nativní knihovnu DLL.
Pokud typ projektu nepodporuje model COM, tato karta se v dialogovém okně Správce odkazů nezobrazí.
Karta Řešení
Na kartě Řešení jsou uvedeny všechny kompatibilní projekty v aktuálním řešení, a to na dílčí kartě Projekty.
Projekt může odkazovat na jiný projekt, který cílí na jinou verzi rozhraní .NET Framework.Můžete například vytvořit projekt, který cílí na .NET Framework 4, ale který odkazuje na sestavení vytvořené pro rozhraní .NET Framework 2.Projekt pro rozhraní .NET Framework 2 ale nemůže odkazovat na projekt pro .NET Framework 4.Další informace naleznete v tématu Zaměření na specifickou verzi rozhraní .NET Framework nebo profilu.
Projekt, který cílí na .NET Framework 4, je nekompatibilní s projektem, který cílí na .NET Framework 4 Client Profile.
V sadě Visual Studio 2012 se vytváří odkaz na soubor namísto odkazu na projekt, pokud jeden projekt cílí na rozhraní .NET Framework 4 a jiný projekt cílí na dřívější verzi.
Projekt, který cílí na Aplikace .NET pro Windows Store, nemůže přidat odkaz na projekt, který cílí na .NET Framework, a naopak.
Karta Windows
Karta Windows obsahuje všechny sady SDK, které jsou specifické pro platformy, na kterých běží operační systém Windows.
Soubor WinMD je možné v sadě Visual Studio vygenerovat dvěma způsoby:
Spravované projekty aplikací pro Windows Store: Projekty aplikací pro Windows Store mají na výstupu binární soubory WinMD, pokud je hodnota Vlastnosti projektu | Typ výstupu nastavena na Soubor WinMD.Název souboru WinMD musí představovat nadřazený obor názvů všech oborů názvů, které existují jeho v rámci.Pokud například projekt obsahuje obory názvů A.B a A.B.C, možné názvy pro soubory WinMD na jeho výstupu jsou A.winmd a A.B.winmd.Pokud uživatel zadá hodnotu Vlastnosti projektu | Název sestavení nebo Vlastnosti projektu | Obor názvů, která je mimo sadu oborů názvů v projektu, nebo v rámci projektu není žádný nadřazený obor názvů, vygeneruje se při sestavení upozornění: „A.winmd není platný název souboru .winmd pro toto sestavení.Všechny typy v rámci souboru metadat systému Windows musejí existovat v podřízeném oboru názvů daného názvu souboru.Typy, které neexistují v podřízeném oboru daného názvu souboru, nebude možné za běhu nalézt.V tomto sestavení je nejmenší společný obor názvů CSWSClassLibrary1“.Projekt aplikace pro klasickou plochu v jazyce Visual Basic nebo Visual C# může využívat pouze soubory WinMD vygenerované pomocí sad SDK pro Windows 8, které jsou známy jako soubory WinMD první strany, a nemůže generovat soubory WinMD.
Nativní projekty aplikací pro Windows Store: Nativní soubor WinMD obsahuje pouze metadata.Jeho implementace se nachází v samostatném souboru knihovny DLL.Nativní binární soubory je možné vytvořit tak, že vyberete šablonu projektu Součásti prostředí Windows Runtime v dialogovém okně Nový projekt nebo začnete prázdným projektem a upravíte vlastnosti projektu tak, aby vygeneroval soubor WinMD.Pokud projekt obsahuje nesouvislé obory názvů, chyba sestavení oznámí uživateli, aby sloučit své obory názvů nebo spustit nástroj MSMerge.
Karta Windows se skládá ze dvou podskupin.
Podskupina Jádro
Podskupina Jádro obsahuje seznam všech souborů WinMD (pro elementy prostředí Windows Runtime) v sadě SDK pro cílenou verzi systému Windows.
Ve výchozím nastavení obsahují projekty aplikací pro Windows Store odkazy na všechny soubory WinMD v sadě SDK pro Windows 8 už při vytvoření projektu.Uzel jen pro čtení ve složce Odkazy v Průzkumníku řešení ve spravovaných projektech označuje odkaz na celou sadu SDK pro Windows 8.Proto podskupina Jádro ve Správci odkazů nezobrazí seznam všech sestavení ze sady SDK pro Windows 8 a namísto toho se zobrazí zpráva: „Na sadu Windows SDK se již odkazuje.Pomocí Prohlížeče objektů můžete prozkoumat odkazy v sadě Windows SDK.“
V projektech aplikací pro klasickou plochu se ve výchozím nastavení podskupina Jádro nezobrazuje.Prostředí Windows Runtime můžete přidat tak, že otevřete místní nabídku pro uzel projektu, kliknete na příkaz Uvolnit projekt, přidáte následující fragment kódu a znovu otevřete projekt (na uzlu projektu zvolíte příkaz Znovu načíst projekt).Při otevření dialogového okna Správce odkazů se zobrazí podskupina Jádro.
<PropertyGroup>
<TargetPlatformVersion>8.0</TargetPlatformVersion>
</PropertyGroup>
V této podskupině je nutné zaškrtnout políčko Windows.Poté budete moci používat elementy prostředí Windows Runtime.Je také vhodné přidat System.Runtime, ve kterém Windows Runtime definuje některé standardní třídy a rozhraní, například rozhraní IEnumerable, které se používají v knihovnách prostředí Windows Runtime.Další informace o tom, jak přidat System.Runtime, naleznete v tématu Spravované aplikace pro klasickou plochu a prostředí Windows Runtime.
Podskupina Rozšíření
Podskupina Rozšíření obsahuje seznam uživatelských sad SDK, které rozšiřují cílenou platformu Windows.Tato karta se zobrazuje pouze pro projekty aplikací pro Windows Store.Projekty aplikací pro klasickou plochu tuto kartu nezobrazují, protože používají pouze soubory .winmd první strany.
Sada SDK je kolekce souborů, které sada Visual Studio považuje za jedinou součást.Na kartě Rozšíření jsou sady SDK vztahující se k projektu, ze kterého bylo vyvoláno dialogové okno Správce odkazů, uvedeny jako jedna položka.Po přidání do projektu je veškerý obsah sady SDK využíván sadou Visual Studio tak, že uživatel nemusí provádět žádné další akce za účelem využití obsahu sady SDK v prostředí IntelliSense, sadě nástrojů, návrhářích, Prohlížeči objektů, sestavení, nasazení, ladění a balení.Další informace o tom, jak zobrazit vaši sadu SDK na kartě Rozšíření, naleznete v tématu Jak: vytvoření Software Development Kit..
[!POZNÁMKA]
Pokud se projekt odkazuje na sadu SDK, která závisí na jiné sadě SDK, sada Visual Studio nebude využívat druhou sadu SDK, pokud uživatel ručně nepřidá odkaz na tuto druhou sadu SDK.Když uživatel vybere sadu SDK na kartě Rozšíření, dialogové okno Správce odkazů pomáhá uživateli určit závislosti sady SDK zobrazením jak názvu a verze sady SDK, tak i názvu případných závislostí sady SDK v podokně podrobností.Pokud si uživatel nevšimne závislostí a přidá pouze sadu SDK, nástroj MSBuild vyzve uživatele k přidání závislostí.
Pokud typ projektu nepodporuje podskupinu Rozšíření, tato karta se v dialogovém okně Správce odkazů nezobrazí.
Tlačítko Procházet
Pomocí tlačítka Procházet můžete vyhledat součást v systému souborů.
Projekt se může odkazovat na součást, která cílí na jinou verzi rozhraní .NET Framework.Můžete například vytvořit aplikaci, která cílí na rozhraní .NET Framework 4 Client Profile, jež odkazuje na součást, která cílí na rozhraní .NET Framework 2.Další informace naleznete v tématu Zaměření na specifickou verzi rozhraní .NET Framework nebo profilu.
Měli byste se vyhnout přidávání odkazů na soubory do výstupů jiného projektu ve stejném řešení, protože to může vést k chybám při kompilaci.Místo toho použijte kartu Řešení dialogového okna Správce odkazů k vytvoření odkazů mezi projekty.Tento postup usnadňuje vývoj v týmu, neboť umožňuje lepší správu knihoven tříd, které vytvoříte ve svých projektech.Další informace naleznete v tématu Řešení potíží s poškozenými odkazy.
Nemůžete přejít k sadě SDK a přidat ji do projektu.Je možné přejít pouze k souboru (například sestavení nebo souboru .winmd) a přidat jej do projektu.
Při vytváření odkazu na soubor WinMD je očekávané rozložení takové, že soubory FileName.winmd, FileName.dll a FileName.pri jsou umístěny spolu.Pokud odkazujete na soubor WinMD v následujících scénářích, do výstupního adresáře projektu budou zkopírovány neúplné sady souborů a v důsledku toho dojde k chybám při sestavení a za běhu.
Nativní součást: nativní projekt vytvoří jeden soubor WinMD pro každou sadu nesouvislých oborů názvů a jednu knihovnu DLL, která je tvořena implementací.Soubory WinMDs budou mít nesouvislé názvy.Při odkazování na tento soubor nativní součásti nástroj MSBuild nerozpozná, že tyto různě nazvané soubory WinMD tvoří jednu součást.V důsledku toho budou zkopírovány pouze identicky pojmenované soubory FileName.dll a FileName.winmd a dojde k chybám za běhu.Chcete-li tento problém vyřešit, vytvořte rozšiřující sadu SDK.Další informace naleznete v tématu Jak: vytvoření Software Development Kit..
Využívající ovládací prvky: ovládací prvek XAML přinejmenším obsahuje soubory FileName.winmd, FileName.dll, FileName.pri, XamlName.xaml a ImageName.jpg.Při sestavení projektu nebudou soubory prostředků, které jsou přidruženy k odkazu na soubor, zkopírovány do výstupního adresáře projektu. Zkopírovány budou pouze soubory FileName.winmd, FileName.dll a FileName.pri.Bude zaznamenána chyba sestavení, která uživatele informuje, že chybějí zdroje XamlName.xaml a ImageName.jpg.Aby sestavení proběhlo úspěšně, bude uživatel muset ručně zkopírovat tyto soubory prostředků do výstupního adresáře projektu pro sestavení a ladění/dobu běhu.Chcete-li tento problém vyřešit, buď vytvořte rozšiřující sadu SDK pomocí kroků v tématu Jak: vytvoření Software Development Kit., nebo upravte soubor projektu a přidejte do něj následující vlastnost:
<PropertyGroup> <GenerateLibraryOutput>True</GenerateLibraryOutput> </PropertyGroup>[!POZNÁMKA]
Pokud tuto vlastnost přidáte, může být sestavení pomalejší.
Nedávné
Kartu Nedávné podporují karty Sestavení, COM, Windows a Procházet. Tato karta obsahuje seznam součástí, které byly v poslední době přidány do projektu.
Hledat
Panel hledání v dialogovém okně Správce odkazů funguje na kartě, která má aktuálně fokus.Pokud například uživatel zadá na panelu hledání text „Systém“ v okamžiku, kdy má fokus karta Řešení, nevrátí hledání žádné výsledky, pokud řešení není tvořeno názvem projektu, který obsahuje slovo „Systém“.
Viz také
Úkoly
Postupy: Přidání nebo odebrání odkazů pomocí dialogového okna Přidat odkaz