Omówienie docelowania ram

W programie Visual Studio możesz określić wersję platformy .NET, dla której ma być przeznaczony projekt. Określanie platformy pomaga zagwarantować, że aplikacja używa tylko funkcji dostępnych w określonej wersji platformy. Aby aplikacje .NET Framework działały na innym komputerze, wersja platformy przeznaczona dla aplikacji musi być zgodna z wersją platformy zainstalowaną na komputerze.

Rozwiązanie programu Visual Studio może zawierać projekty przeznaczone dla różnych wersji platformy .NET. Należy jednak pamiętać, że można kompilować tylko z jedną wersją platformy .NET, korzystając z odwołań warunkowych dla pojedynczej kompilacji, lub tworzyć różne pliki binarne dla docelowych środowisk. Aby uzyskać więcej informacji na temat platform docelowych, zobacz Platformy docelowe.

Napiwek

Można również dostosowywać aplikacje do różnych platform. Aby uzyskać więcej informacji, zobacz Multitargeting.

Funkcje określania elementów docelowych platformy

Określanie docelowych struktur obejmuje następujące funkcje:

• Po otwarciu projektu, który jest przeznaczony dla starszej wersji platformy, program Visual Studio może automatycznie uaktualnić projekt lub pozostawić docelowy as-is.

• Podczas tworzenia projektu programu .NET Framework można określić wersję programu .NET Framework, którą chcesz kierować.

• W jednym projekcie można obsługiwać wiele frameworków.

• W każdym z kilku projektów w tym samym rozwiązaniu można wybrać inną wersję platformy .NET.

• Możesz zmienić wersję platformy .NET, która jest przeznaczona dla istniejącego projektu.

  Po zmianie wersji platformy .NET przeznaczonej dla projektu program Visual Studio wprowadza wszelkie wymagane zmiany w odwołaniach i plikach konfiguracji.

Podczas pracy nad projektem, który jest przeznaczony dla starszej wersji platformy, program Visual Studio dynamicznie zmienia środowisko programistyczne w następujący sposób:

• Filtruje elementy w oknie dialogowym Dodawanie nowego elementu, oknie dialogowym Dodawanie nowego odwołania oraz oknie dialogowym Dodawanie odwołania do usługi, aby pominąć opcje, które nie są dostępne w wersji docelowej.

• Filtruje on kontrolki niestandardowe w przyborniku , aby usunąć te, które nie są dostępne w wersji docelowej i wyświetlać tylko najbardziej up-tokontrolki -date, gdy dostępnych jest wiele kontrolek.

• Funkcja filtruje IntelliSense, aby pominąć funkcje języka, które nie są dostępne w wersji docelowej.

• Filtruje właściwości w oknie właściwości , aby pominąć te, które nie są dostępne w wersji docelowej.

• Filtruje opcje menu, aby pominąć opcje, które nie są dostępne w wersji docelowej.

• W przypadku kompilacji używa wersji kompilatora i opcji kompilatora, które są odpowiednie dla wersji docelowej.

Notatka

• Określanie platformy docelowej nie gwarantuje, że aplikacja będzie działać poprawnie. Musisz przetestować aplikację, aby upewnić się, że działa ona w wersji docelowej.
• Nie można określać wersji platformy poniżej .NET Framework 2.0.

Zmienianie platformy docelowej

W istniejącym projekcie Visual Basic, C# lub F# zmieniasz docelową wersję platformy .NET w oknie dialogowym właściwości projektu. pl-PL: Aby uzyskać informacje na temat zmiany wersji docelowej dla projektów języka C++, zobacz W jaki sposób zmienić strukturę docelową i narzędzia platformy.

1. W eksploratorze rozwiązań otwórz menu kontekstowe prawym przyciskiem myszy dla projektu, który chcesz zmienić, a następnie wybierz pozycję właściwości .

2. W lewej kolumnie okna Właściwości wybierz kartę Aplikacja.

   Uwaga

   Po utworzeniu aplikacji platformy UWP nie można zmienić docelowej wersji systemu Windows lub platformy .NET.

3. Na liście Target Framework wybierz odpowiednią wersję.

   W przypadku projektu platformy .NET Framework , okno dialogowemoże wyglądać podobnie do tego na poniższym zrzucie ekranu.

   

   W przypadku projektu platformy .NET , okno dialogowe może wyglądać jak na poniższym zrzucie ekranu.

   

4. Jeśli zostanie wyświetlone okno dialogowe weryfikacji, wybierz przycisk Tak.

   Projekt się rozładowuje. Po ponownym załadowaniu skupia się na wersji platformy .NET, którą właśnie wybrałeś.

Określanie wielu platform docelowych

Za pomocą platformy .NET 5 lub nowszej można utworzyć projekt dla wielu struktur w jednej kompilacji, ręcznie edytując plik projektu. Otwórz plik projektu i zastąp właściwość TargetFramework wartością TargetFrameworksi określ listę obiektów Target Framework Monikers (TFMs), rozdzielonych średnikami, jak w poniższym kodzie:

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

Zobacz listę TFM na stronie Platformy docelowe w projektach stylu SDK.

Po wprowadzeniu tej zmiany należy ponownie załadować projekt. Następnie, jeśli otworzysz okno właściwości , na karcie Aplikacja możesz edytować listę platform docelowych.

Notatka

Jeśli kod zawiera odwołania do innej wersji platformy .NET niż docelowa, komunikaty o błędach mogą pojawić się podczas kompilowania lub uruchamiania kodu. Aby rozwiązać te błędy, zmodyfikuj odwołania. Zobacz Rozwiązywanie problemów z błędami kompilacji dla platformy .NET.

Napiwek

W zależności od platformy docelowej można ją przedstawić na następujące sposoby w pliku projektu:

• W przypadku aplikacji .NET Core: <TargetFramework>netcoreapp2.1</TargetFramework>
• W przypadku aplikacji .NET Standard: <TargetFramework>netstandard2.0</TargetFramework>
• W przypadku aplikacji .NET Framework: <TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>

Wybieranie wersji platformy docelowej

Podczas tworzenia projektu programu .NET Framework możesz wybrać docelową wersję programu .NET Framework po wybraniu szablonu projektu. Lista dostępnych struktur zawiera zainstalowane wersje platform, które mają zastosowanie do wybranego typu szablonu. W przypadku szablonów projektów platformy non-.NET Framework, na przykład szablonów platformy .NET Core lista rozwijana Framework nie jest wyświetlana.

Jeśli zdecydujesz się utworzyć projekt .NET Framework, zobaczysz interfejs podobny do poniższego zrzutu ekranu:

Jeśli zdecydujesz się utworzyć projekt platformy .NET, zobaczysz interfejs użytkownika podobny do poniższych dwóch zrzutów ekranu.

Pierwszym wyświetlonym ekranem jest okno dialogowe Konfigurowanie nowego projektu.

Drugim ekranem, który zobaczysz, jest okno dialogowe Dodatkowe opcje.

Rozwiązywanie problemów z odwołaniami do zestawu systemu i użytkownika

Aby dostosować wersję .NET, należy najpierw zainstalować odpowiednie odwołania do zestawów. Pakiety deweloperskie dla różnych wersji platformy .NET można pobrać na stronie pobierania .NET.

W przypadku projektów .NET Framework okno dialogowe Dodawanie odwołania wyłącza zestawy systemowe, które nie odnoszą się do docelowej wersji .NET Framework, aby nie można ich było przypadkowo dodać do projektu. (Zestawy systemowe są plikami .dll dołączonymi do wersji programu .NET Framework). Odwołania należące do wersji struktury, która jest wyższa niż wersja docelowa, nie zostaną rozwiązane, a nie można dodać kontrolek, które zależą od takiego odwołania. Jeśli chcesz włączyć takie odwołanie, ustaw element docelowy .NET Framework projektu na taki, który zawiera odwołanie.

Aby uzyskać więcej informacji na temat odwołań do zestawów, zobacz Rozwiązywanie odwołań do zestawów na etapie projektowania.

Włączanie LINQ

Gdy celem jest .NET Framework 3.5 lub nowszy, automatycznie dodawane jest odwołanie do System.Core oraz import na poziomie projektu dla System.Linq (tylko w Visual Basic). Jeśli chcesz używać funkcji LINQ, musisz również włączyć Option Infer (tylko w języku Visual Basic). Odwołanie i importowanie są usuwane automatycznie, jeśli zmienisz element docelowy na starszą wersję programu .NET Framework. Aby uzyskać więcej informacji, zobacz Praca z LINQ.

Zobacz też

• Platformy docelowe
• Celowanie wielokrotne (MSBuild)
• Instrukcje: modyfikowanie platformy docelowej i zestawu narzędzi platformy (C++)