Dela via

Anvisningar: Konfigurera en app för att stödja .NET Framework 4 eller senare versioner

  • Artikel

Alla appar som är värdar för CLR (Common Language Runtime) måste starta eller aktivera CLR för att kunna köra hanterad kod. Vanligtvis körs en .NET Framework-app på den version av CLR som den byggdes på, men du kan ändra det här beteendet för skrivbordsappar med hjälp av en programkonfigurationsfil (kallas ibland för en app.config-fil). Du kan dock inte ändra standardaktiveringsbeteendet för Windows Store-appar eller Windows Telefon-appar med hjälp av en programkonfigurationsfil. Den här artikeln beskriver hur du gör så att din skrivbordsapp kan köras på en annan version av .NET Framework och ger ett exempel på hur du riktar version 4 eller senare versioner till mål.

Den version av .NET Framework som en app körs på bestäms i följande ordning:

  • Konfigurationsfil.

    Om programkonfigurationsfilen innehåller <körtidsposter> som stöds och anger en eller flera .NET Framework-versioner och en av dessa versioner finns på användarens dator, körs appen på den versionen. Konfigurationsfilen läser körningsposter <som stöds> i den ordning de visas och använder den första .NET Framework-versionen som visas på användarens dator. (Använd <requiredRuntime-element> för version 1.0.)

  • Kompilerad version.

    Om det inte finns någon konfigurationsfil, men den version av .NET Framework som appen byggdes på finns på användarens dator, körs appen på den versionen.

  • Den senaste versionen har installerats.

    Om den version av .NET Framework som appen byggdes på inte finns och en konfigurationsfil inte anger någon version i ett <.NET Framework-element> som stöds, försöker appen köra den senaste versionen av .NET Framework som finns på användarens dator.

    .NET Framework 1.0, 1.1, 2.0, 3.0 och 3.5-appar körs dock inte automatiskt på .NET Framework 4 eller senare, och i vissa fall kan användaren få ett fel och kan uppmanas att installera .NET Framework 3.5. Aktiveringsbeteendet kan också bero på användarens operativsystem, eftersom olika versioner av Windows-systemet innehåller olika versioner av .NET Framework. Om din app stöder både .NET Framework 3.5 och 4 eller senare rekommenderar vi att du anger detta med flera poster i konfigurationsfilen för att undvika .NET Framework-initieringsfel. Mer information finns i Versioner och beroenden.

Du kanske också vill konfigurera .NET Framework 3.5-appar så att de körs på .NET Framework 4- eller senare versioner, även på datorer som har .NET Framework 3.5 installerade, för att dra nytta av prestandaförbättringarna i version 4 och senare versioner.

Viktigt!

Vi rekommenderar att du alltid testar din app på varje .NET Framework-version som du stöder. Mer information om hur du uppgraderar programmet för att stödja senare .NET Framework-versioner finns i Versionskompatibilitet .

Information om hur du ändrar dina .NET Framework 1.0- och 1.1-appar för att stödja Windows 7 och Windows 8 finns i Migrera från .NET Framework 1.1.

Så här konfigurerar du appen så att den körs på .NET Framework 4 eller senare versioner

  1. Lägg till eller leta upp konfigurationsfilen för .NET Framework-projektet. Konfigurationsfilen för en app finns i samma katalog och har samma namn som appen, men har ett .config-tillägg. För en app med namnet MyExecutable.exe heter till exempel programkonfigurationsfilen MyExecutable.exe.config.

    Om du vill lägga till en konfigurationsfil går du till menyraden i Visual Studio och väljer Projekt, Lägg till nytt objekt. Välj Allmänt i det vänstra fönstret och välj sedan Konfigurationsfil. Ge konfigurationsfilen namnet App.config. De här menyalternativen är inte tillgängliga för Windows Store-app- eller Windows Phone-appprojekt, eftersom du inte kan ändra aktiveringsprincipen på dessa plattformar.

  2. Lägg till elementetruntime ><som stöds enligt följande i programkonfigurationsfilen:

    <configuration>
  <startup>
    <supportedRuntime version="version"/>
  </startup>
</configuration>

    där <versionen> anger den CLR-version som överensstämmer med den .NET Framework-version som din app stöder. Använd följande strängar:

    • .NET Framework 1.0: "v1.0.3705"

    • .NET Framework 1.1: "v1.1.4322"

    • .NET Framework 2.0, 3.0 och 3.5: "v2.0.50727"

    • .NET Framework 4 och senare versioner: "v4.0"

    Du kan lägga till flera <körningselement som stöds> , som anges i prioritetsordning, för att ange stöd för flera versioner av .NET Framework.

Följande tabell visar hur programkonfigurationsfilinställningar och .NET Framework-versioner som är installerade på en dator avgör vilken version en .NET Framework 3.5-app körs på. Exemplen är specifika för ett .NET Framework 3.5-program, men du kan använda liknande logik för att rikta program som skapats med tidigare .NET Framework-versioner. Observera att versionsnumret för .NET Framework 2.0 (v2.0.50727) används för att ange .NET Framework 3.5 i programkonfigurationsfilen.

Filinställning för App.config På datorn med version 3.5 installerad På datorn med versionerna 3.5 och 4 eller senare installerade På datorn med version 4 eller senare installerade versioner
Ingen Körs på 3,5 Körs på 3,5 Visar felmeddelande som uppmanar användaren att installera rätt version*
<supportedRuntime version="v2.0.50727"/> Körs på 3,5 Körs på 3,5 Visar felmeddelande som uppmanar användaren att installera rätt version*
<supportedRuntime version="v2.0.50727"/>
<supportedRuntime version="v4.0"/>		 Körs på 3,5 Körs på 3,5 Körs på 4 eller senare versioner
<supportedRuntime version="v4.0"/>
<supportedRuntime version="v2.0.50727"/>		 Körs på 3,5 Körs på 4 eller senare versioner Körs på 4 eller senare versioner
<supportedRuntime version="v4.0"/> Visar felmeddelande som uppmanar användaren att installera rätt version* Körs på 4 eller senare versioner Körs på 4 eller senare versioner

* Mer information om det här felmeddelandet och hur du undviker det finns i .NET Framework-initieringsfel: Hantera användarupplevelsen.

Se även