Přehled cílení na rámec

V sadě Visual Studio můžete zadat verzi rozhraní .NET, na kterou chcete projekt cílit. Cílení na architekturu pomáhá zaručit, že aplikace používá pouze funkce, které jsou k dispozici v zadané verzi architektury. Aby aplikace rozhraní .NET Framework běžely na jiném počítači, musí být verze rozhraní, na kterou cíl aplikace cílí, kompatibilní s verzí rozhraní, která je v počítači nainstalovaná.

Řešení sady Visual Studio může obsahovat projekty, které cílí na různé verze .NET. Mějte však na paměti, že můžete vytvořit pouze jednu verzi .NET, buď s využitím podmínkových referencí pro jedno sestavení, nebo sestavením různých binárních souborů pro každý cílový framework. Další informace o cílových architekturách naleznete v tématu Cílové architektury.

Spropitné

Můžete také cílit na aplikace pro různé platformy. Další informace naleznete v vícenásobné cílení.

Funkce zaměřování v rámci architektury

Cílení na architekturu zahrnuje následující funkce:

• Když otevřete projekt, který cílí na starší verzi architektury, visual Studio může automaticky upgradovat projekt nebo ponechat cíl as-is.

• Při vytváření projektu rozhraní .NET Framework můžete zadat verzi rozhraní .NET Framework, na kterou chcete cílit.

• V jednom projektu můžete cílit na více architektur.

• V každém z několika projektů ve stejném řešení můžete cílit na jinou verzi .NET.

• Můžete změnit verzi rozhraní .NET, na kterou cílí stávající projekt.

  Když změníte verzi rozhraní .NET, na kterou projekt cílí, visual Studio provede všechny požadované změny odkazů a konfiguračních souborů.

Když pracujete na projektu, který cílí na starší verzi architektury, Visual Studio dynamicky změní vývojové prostředí následujícím způsobem:

• Filtruje položky v dialogovém okně Přidat novou položku, dialogovém okně Přidat nový odkaz a dialogovém okně Přidat referenci služby, aby vynechalo možnosti, které nejsou dostupné v cílové verzi.

• Filtruje vlastní ovládací prvky v panelu nástrojů, aby se odebraly ty, které nejsou dostupné v cílové verzi, a aby zobrazovaly pouze ovládací prvky up-to-date, pokud je k dispozici více ovládacích prvků.

• Filtruje IntelliSense, aby vynechával jazykové funkce, které nejsou dostupné v cílové verzi.

• Filtruje vlastnosti v okně Vlastnosti a vynechá ty, které nejsou v cílové verzi dostupné.

• Filtruje možnosti nabídky tak, aby vynechaly možnosti, které nejsou v cílové verzi dostupné.

• Pro sestavení používá verzi kompilátoru a možnosti kompilátoru, které jsou vhodné pro cílovou verzi.

Poznámka

• Cílení na architekturu nezaručuje, že vaše aplikace bude fungovat správně. Aplikaci musíte otestovat, abyste měli jistotu, že běží na cílové verzi.
• Verze rozhraní nižší než .NET Framework 2.0 nelze cílit.

Změna cílové architektury

V existujícím projektu jazyka Visual Basic, C# nebo F# změníte cílovou verzi .NET v dialogovém okně vlastností projektu. Informace o tom, jak změnit cílovou verzi projektů C++, najdete v tématu Postup úpravy cílové architektury a sady nástrojů platformy.

1. V Průzkumníka řešeníotevřete místní nabídku po kliknutí pravým tlačítkem myši pro projekt, který chcete změnit, a pak zvolte Vlastnosti.

2. V levém sloupci okna Vlastnosti zvolte kartu Aplikace.

   Poznámka

   Po vytvoření aplikace pro UPW nemůžete změnit cílovou verzi systému Windows nebo .NET.

3. V seznamu Target Framework zvolte požadovanou verzi.

   U projektu rozhraní .NET Frameworkmůže dialogové okno vypadat podobně jako na následujícím snímku obrazovky:

   

   U projektu .NETmůže dialogové okno vypadat podobně jako na následujícím snímku obrazovky:

   

4. Pokud se zobrazí dialogové okno pro ověření, zvolte tlačítko Ano.

   Projekt se načítá. Když se znovu načte, cílí na verzi .NET, kterou jste právě zvolili.

Cílení na více rámců

S .NET 5 a novějším můžete vytvořit projekt pro více architektur v jednom sestavení ruční úpravou souboru projektu. Otevřete soubor projektu a nahraďte vlastnost TargetFrameworkTargetFrameworksa zadejte seznam monikerů cílové architektury (TFMs) oddělený středníky, jako v následujícím kódu:

   <TargetFrameworks>net7.0;net8.0</TargetFrameworks>

Seznam TFM najdete v cílových rámcích v projektech SDK stylu.

Po provedení této změny je nutné projekt znovu načíst. Pokud pak otevřete okno Vlastnosti, můžete na kartě Aplikace upravit seznam cílových frameworků.

Poznámka

Pokud váš kód obsahuje odkazy na jinou verzi rozhraní .NET, než na kterou jste cílí, můžou se při kompilaci nebo spuštění kódu zobrazit chybové zprávy. Pokud chcete tyto chyby vyřešit, upravte odkazy. Viz Odstraňování problémů s chybami cílení pro .NET.

Spropitné

V závislosti na cílovém rozhraní může být v souboru projektu reprezentována následujícími způsoby:

• Pro aplikaci .NET Core: <TargetFramework>netcoreapp2.1</TargetFramework>
• Pro aplikaci .NET Standard: <TargetFramework>netstandard2.0</TargetFramework>
• Pro aplikaci .NET Framework: <TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>

Výběr verze cílové architektury

Při vytváření projektu rozhraní .NET Framework můžete po výběru šablony projektu vybrat cílovou verzi rozhraní .NET Framework. Seznam dostupných architektur zahrnuje nainstalované verze rozhraní, které se vztahují na vybraný typ šablony. U šablon projektů non-.NET Framework, například šablon .NET Core, se rozevírací seznam Framework nezobrazí.

Pokud se rozhodnete vytvořit projekt rozhraní .NET Framework, zobrazí se rozhraní podobné následujícímu snímku obrazovky:

Pokud se rozhodnete vytvořit projekt .NET, zobrazí se uživatelské rozhraní (UI), které je podobné následujícím dvěma snímkům obrazovky.

První obrazovka, kterou uvidíte, je dialogové okno Konfigurace nového projektu.

Druhá obrazovka, kterou uvidíte, je dialogové okno Další možnosti.

Řešení odkazů na sestavení systému a uživatelů

Chcete-li zaměřit se na verzi .NET, musíte nejprve nainstalovat příslušná sestavení. Balíčky pro vývojáře pro různé verze rozhraní .NET si můžete stáhnout na stránce stažení .NET.

U projektů rozhraní .NET Framework dialogové okno Přidat referenční zakáže systémová sestavení, která se netýkají cílové verze rozhraní .NET Framework, aby se nedají neúmyslně přidat do projektu. (Systémová sestavení jsou .dll soubory, které jsou součástí verze rozhraní .NET Framework.) Odkazy, které patří do verze rozhraní, která je vyšší než cílová verze, se nepřeloží a ovládací prvky, které na takovém odkazu závisejí, se nedají přidat. Pokud chcete takový odkaz povolit, resetujte cíl rozhraní .NET Framework projektu na takový, který obsahuje odkaz.

Další informace o odkazech na sestavení naleznete v tématu Řešení sestavení v době návrhu.

Povolení LINQ

Když cílíte na rozhraní .NET Framework 3.5 nebo novější, automaticky se přidá odkaz na System.Core a import na úrovni projektu pro System.Linq (pouze v jazyce Visual Basic). Pokud chcete používat funkce LINQ, musíte také zapnout Option Infer (pouze v jazyce Visual Basic). Odkaz a import se odeberou automaticky, pokud změníte cíl na starší verzi rozhraní .NET Framework. Další informace naleznete v tématu Práce s LINQ.

Viz také

• cílové frameworky
• Vícecestné cílení (MSBuild)
• Postupy: Úprava cílové architektury a sady nástrojů platformy (C++)