Keretrendszer-célzás áttekintése

A Visual Studióban megadhatja a .NET azon verzióját, amelyet meg szeretne célozni a projekt számára. A keretrendszer-célzás segít garantálni, hogy az alkalmazás csak a megadott keretrendszerverzióban elérhető funkciókat használja. Ahhoz, hogy a .NET-keretrendszeralkalmazások egy másik számítógépen fussanak, az alkalmazás által célként megadott keretrendszerverziónak kompatibilisnek kell lennie a számítógépre telepített keretrendszerverzióval.

A Visual Studio-megoldások olyan projekteket tartalmazhatnak, amelyek a .NET különböző verzióit célják. Vegye figyelembe azonban, hogy a .NET egyetlen verziójára csak egy buildet készíthet hivatkozási feltételekkel, vagy külön bináris fájlokat hozhat létre minden egyes célkeretrendszerhez. A cél-keretrendszerekről további információt Cél-keretrendszerekcímű témakörben talál.

Borravaló

Különböző platformokon is megcélozhat alkalmazásokat. További információkért lásd a Többcélú célzásrész.

Keretrendszer célzási funkciói

A keretrendszer-célzás a következő funkciókat tartalmazza:

• Egy korábbi keretrendszerverziót célzó projekt megnyitásakor a Visual Studio automatikusan frissítheti a projektet, vagy elhagyhatja a cél as-is.

• .NET-keretrendszer-projekt létrehozásakor megadhatja a megcélzni kívánt .NET-keretrendszer verzióját.

• Egyetlen projektben több keretrendszert is célozhat .

• A .NET egy másik verzióját is megcélzhatja ugyanabban a megoldásban több projektben.

• Módosíthatja a .NET azon verzióját, amelyet egy meglévő projekt megcéloz.

  Amikor módosítja a .NET azon verzióját, amelyet egy projekt megcéloz, a Visual Studio végrehajtja a szükséges módosításokat a hivatkozásokon és a konfigurációs fájlokon.

Ha egy korábbi keretrendszerverziót célzó projekten dolgozik, a Visual Studio dinamikusan módosítja a fejlesztési környezetet az alábbiak szerint:

• Szűri az Új elem hozzáadása párbeszédpanelen, az Új hivatkozás hozzáadása párbeszédpanelen, valamint a Szolgáltatáshivatkozás hozzáadása párbeszédpanelen lévő elemeket, hogy kihagyja a célzott verzióban nem elérhető választási lehetőségeket.

• Szűri a eszközkészlet egyéni vezérlőit, eltávolítja azokat, amelyek nem érhetők el a célzott verzióban, és csak a legtöbb up-to-date vezérlőt jeleníti meg, ha több vezérlő érhető el.

• Szűri az IntelliSense-t, hogy kizárja a célzott verzióban nem elérhető nyelvi funkciókat.

• Szűri a Tulajdonságok ablakban lévő tulajdonságokat, hogy kihagyja azokat, amelyek nem érhetők el a célzott verzióban.

• Szűri a menübeállításokat, hogy kihagyja a célzott verzióban nem elérhető beállításokat.

• Buildek esetén a fordító verzióját és a megcélzott verziónak megfelelő fordítóbeállításokat használja.

Jegyzet

• A keretrendszer-célzás nem garantálja, hogy az alkalmazás megfelelően fog futni. Tesztelnie kell az alkalmazást, hogy ellenőrizze, hogy a célverzióval fut-e.
• A .NET-keretrendszer 2.0-s verziói nem célozhatók meg.

A cél keretrendszer módosítása

Egy meglévő Visual Basic, C# vagy F# projektben a projekttulajdonságok párbeszédpanelen módosíthatja a cél .NET-verziót. A C++-projektek célverziójának módosításáról további információt a A cél keretrendszer és a platformeszközkészlet módosítása című témakörben talál.

1. A Megoldáskezelőbennyissa meg a módosítani kívánt projekt helyi menüjét, majd válassza a Tulajdonságoklehetőséget.

2. A Tulajdonságok ablak bal oldali oszlopában válassza az Alkalmazás lapot.

   Jegyzet

   UWP-alkalmazás létrehozása után sem a Windows, sem a .NET célzott verzióját nem módosíthatja.

3. A Target Framework listájában válassza ki a kívánt verziót.

   Egy .NET-keretrendszer projektesetén a megjelenő párbeszédpanel az alábbi képernyőképhez hasonló lehet:

   

   Egy .NET-projektesetén a párbeszédpanel az alábbi képernyőképhez hasonló lehet:

   

4. Ha megjelenik egy ellenőrző párbeszédpanel, válassza az Igen gombot.

   A projekt kiüríti a projektet. Újratöltéskor az imént kiválasztott .NET-verziót célozza meg.

Több keretrendszer megcélzása

A .NET 5 és újabb verzióival a projektfájl manuális szerkesztésével több keretrendszerhez is létrehozhat projektet egyetlen buildben. Nyissa meg a projektfájlt, cserélje le a TargetFramework tulajdonságot TargetFrameworks-re, majd adja meg a TFM-ek listáját pontosvesszőkkel elválasztva, az alábbi kódhoz hasonlóan:

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

Tekintse meg a TFM-ek listáját SDK-stílusú projektek cél-keretrendszereiben.

A módosítás elvégzése után újra kell betöltenie a projektet. Ezután, ha megnyitja a Tulajdonságok ablakot, a Alkalmazás lapon szerkesztheti a cél keretrendszerek listáját.

Jegyzet

Ha a kód a megcélzotttól eltérő .NET-verzióra mutató hivatkozásokat tartalmaz, hibaüzenetek jelenhetnek meg a kód lefordításakor vagy futtatásakor. A hibák megoldásához módosítsa a hivatkozásokat. Lásd: .NET-célzási hibák elhárítása.

Borravaló

A cél keretrendszertől függően a projektfájlban a következő módokon jeleníthető meg:

• .NET Core-alkalmazás esetén: <TargetFramework>netcoreapp2.1</TargetFramework>
• .NET Standard alkalmazás esetén: <TargetFramework>netstandard2.0</TargetFramework>
• .NET-keretrendszeralkalmazás esetén: <TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>

Cél-keretrendszerverzió kiválasztása

.NET-keretrendszerprojekt létrehozásakor a projektsablon kiválasztása után kiválaszthatja a cél .NET-keretrendszer verzióját. Az elérhető keretrendszerek listája tartalmazza a kiválasztott sablontípusra alkalmazható telepített keretrendszerverziókat. Non-.NET Framework-projektsablonok, például .NET Core-sablonok esetén nem jelenik meg a Keretrendszer legördülő lista.

Ha úgy dönt, hogy létrehozni egy .NET-keretrendszer-projektet, az alábbi képernyőképhez hasonló felület jelenik meg:

Ha úgy dönt, hogy létrehozni egy .NET-projektet, az alábbi két képernyőképhez hasonló felhasználói felület (UI) jelenik meg.

Az első képernyő, amelyet látni fog, az Az új projekt konfigurálása párbeszédpanel.

A második látható képernyő a További beállítások párbeszédpanel.

Rendszer- és felhasználói szerelvényhivatkozások feloldása

A .NET-verzió megcélzásához először telepítenie kell a megfelelő szerelvényhivatkozásokat. A .NET különböző verzióihoz készült fejlesztői csomagokat a .NET-letöltések lapon töltheti le.

A .NET-keretrendszer-projektek esetében a Referencia hozzáadása párbeszédpanel letiltja a cél .NET-keretrendszer verziójához nem tartozó rendszerszerelvényeket, hogy véletlenül ne lehessen hozzáadni őket egy projekthez. (A rendszerszerelvények olyan .dll fájlok, amelyek egy .NET-keretrendszer verziójában találhatók.) A célverziónál magasabb keretrendszerverzióhoz tartozó hivatkozások nem oldhatók fel, és az ilyen hivatkozástól függő vezérlők nem vehetők fel. Ha engedélyezni szeretné ezt a hivatkozást, állítsa vissza a projekt .NET-keretrendszerbeli célját olyanra, amely tartalmazza a hivatkozást.

Az összeállítási hivatkozásokról további információt a Szerelvények feloldása a tervezéskorcímű témakörben talál.

A LINQ engedélyezése

.NET-keretrendszer 3.5-ös vagy újabb verziójának megcélzásakor a rendszer automatikusan hozzáad egy hivatkozást a System.Core- és egy projektszintű importálást a System.Linq számára (csak Visual Basic esetén). Ha LINQ-funkciókat szeretne használni, be kell kapcsolnia a Option Infer is (csak a Visual Basicben). A hivatkozás és az importálás automatikusan törlődik, ha a célértéket egy korábbi .NET-keretrendszer-verzióra módosítja. További információkért lásd: A LINQ használata.

Lásd még:

• Cél-keretrendszerek
• többhelyes (MSBuild)
• Útmutató: A cél-keretrendszer és a platformeszközkészlet (C++) módosítása