Procedure: Een app configureren ter ondersteuning van .NET Framework 4 of nieuwere versies
Alle apps die de Common Language Runtime (CLR) hosten, moeten de CLR starten of activeren om beheerde code uit te voeren. Normaal gesproken wordt een .NET Framework-app uitgevoerd op de versie van de CLR waarop deze is gebouwd, maar u kunt dit gedrag voor bureaublad-apps wijzigen met behulp van een toepassingsconfiguratiebestand (ook wel een app.config-bestand genoemd). U kunt het standaardactiveringsgedrag voor Windows Store-apps of Windows Telefoon-apps echter niet wijzigen met behulp van een toepassingsconfiguratiebestand. In dit artikel wordt uitgelegd hoe u uw bureaublad-app kunt uitvoeren op een andere versie van .NET Framework en een voorbeeld van hoe u versie 4 of hoger kunt gebruiken.
De versie van .NET Framework waarop een app wordt uitgevoerd, wordt bepaald in de volgende volgorde:
Configuratiebestand.
Als het toepassingsconfiguratiebestand ondersteundeRuntime-vermeldingen> bevat <die een of meer .NET Framework-versies opgeven en een van deze versies aanwezig is op de computer van de gebruiker, wordt de app uitgevoerd op die versie. Het configuratiebestand leest ondersteundeRuntime-vermeldingen ><in de volgorde waarin ze worden vermeld en gebruikt de eerste .NET Framework-versie die aanwezig is op de computer van de gebruiker. (Gebruik de <requiredRuntime-element> voor versie 1.0.)
Gecompileerde versie.
Als er geen configuratiebestand is, maar de versie van .NET Framework waarop de app is gebouwd aanwezig is op de computer van de gebruiker, wordt de app uitgevoerd op die versie.
Nieuwste versie geïnstalleerd.
Als de versie van .NET Framework waarop de app is gebouwd niet aanwezig is en een configuratiebestand geen versie opgeeft in een <ondersteundRuntime-element>, probeert de app uit te voeren op de nieuwste versie van .NET Framework die aanwezig is op de computer van de gebruiker.
.NET Framework 1.0, 1.1, 2.0, 3.0 en 3.5-apps worden echter niet automatisch uitgevoerd op .NET Framework 4 of hoger, en in sommige gevallen kan de gebruiker een fout ontvangen en kan worden gevraagd .NET Framework 3.5 te installeren. Het activeringsgedrag kan ook afhankelijk zijn van het besturingssysteem van de gebruiker, omdat verschillende versies van het Windows-systeem verschillende versies van .NET Framework bevatten. Als uw app zowel .NET Framework 3.5 als 4 of hoger ondersteunt, raden we u aan dit aan te geven met meerdere vermeldingen in het configuratiebestand om initialisatiefouten van .NET Framework te voorkomen. Zie Versies en afhankelijkheden voor meer informatie.
Mogelijk wilt u uw .NET Framework 3.5-apps ook configureren voor uitvoering op .NET Framework 4 of nieuwere versies, zelfs op computers waarop .NET Framework 3.5 is geïnstalleerd, om te profiteren van de prestatieverbeteringen in versies 4 en hoger.
Belangrijk
U wordt aangeraden uw app altijd te testen op elke .NET Framework-versie die u ondersteunt. Zie Versiecompatibiliteit voor informatie over het upgraden van uw toepassing ter ondersteuning van latere .NET Framework-versies.
Zie Migreren vanuit .NET Framework 1.1.1 voor informatie over het wijzigen van uw .NET Framework 1.0- en 1.1-apps ter ondersteuning van Windows 7 en Windows 8.
Uw app configureren voor uitvoering op .NET Framework 4 of nieuwere versies
Voeg het configuratiebestand voor het .NET Framework-project toe of zoek het. Het configuratiebestand voor een app bevindt zich in dezelfde map en heeft dezelfde naam als de app, maar heeft de extensie .config. Voor een app met de naam MyExecutable.exe krijgt het toepassingsconfiguratiebestand bijvoorbeeld de naam MyExecutable.exe.config.
Als u een configuratiebestand wilt toevoegen, kiest u Op de menubalk van Visual Studio Project, Nieuw item toevoegen. Kies Algemeen in het linkerdeelvenster en kies vervolgens Configuratiebestand. Geef het configuratiebestand de naam App.config. Deze menuopties zijn niet beschikbaar voor Windows Store-app- of Windows Phone-app-projecten, omdat u het activeringsbeleid op deze platforms niet kunt wijzigen.
Voeg het <ondersteundeRuntime-element> als volgt toe aan het configuratiebestand van de toepassing:
<configuration> <startup> <supportedRuntime version="version"/> </startup> </configuration>waarbij <de versie> de CLR-versie opgeeft die overeenkomt met de .NET Framework-versie die door uw app wordt ondersteund. Gebruik de volgende tekenreeksen:
.NET Framework 1.0: "v1.0.3705"
.NET Framework 1.1: "v1.1.4322"
.NET Framework 2.0, 3.0 en 3.5: "v2.0.50727"
.NET Framework 4 en latere versies: "v4.0"
U kunt meerdere <supportedRuntime-elementen> toevoegen, in volgorde van voorkeur, om ondersteuning voor meerdere versies van .NET Framework op te geven.
In de volgende tabel ziet u hoe instellingen voor toepassingsconfiguratiebestanden en de .NET Framework-versies die op een computer zijn geïnstalleerd, bepalen op welke versie een .NET Framework 3.5-app wordt uitgevoerd. De voorbeelden zijn specifiek voor een .NET Framework 3.5-toepassing, maar u kunt vergelijkbare logica gebruiken als doeltoepassingen die zijn gebouwd met eerdere .NET Framework-versies. Houd er rekening mee dat het versienummer van .NET Framework 2.0 (v2.0.50727) wordt gebruikt om het .NET Framework 3.5 op te geven in het configuratiebestand van de toepassing.
| App.config-bestandsinstelling | Op de computer waarop versie 3.5 is geïnstalleerd | Op de computer waarop versies 3.5 en 4 of hoger zijn geïnstalleerd | Op de computer waarop versie 4 of nieuwere versies zijn geïnstalleerd |
|---|---|---|---|
| Geen | Wordt uitgevoerd op 3.5 | Wordt uitgevoerd op 3.5 | Geeft een foutbericht weer waarin de gebruiker wordt gevraagd de juiste versie te installeren* |
<supportedRuntime version="v2.0.50727"/> |
Wordt uitgevoerd op 3.5 | Wordt uitgevoerd op 3.5 | Geeft een foutbericht weer waarin de gebruiker wordt gevraagd de juiste versie te installeren* |
<supportedRuntime version="v2.0.50727"/> <supportedRuntime version="v4.0"/> |
Wordt uitgevoerd op 3.5 | Wordt uitgevoerd op 3.5 | Wordt uitgevoerd op 4 of nieuwere versies |
<supportedRuntime version="v4.0"/> <supportedRuntime version="v2.0.50727"/> |
Wordt uitgevoerd op 3.5 | Wordt uitgevoerd op 4 of nieuwere versies | Wordt uitgevoerd op 4 of nieuwere versies |
<supportedRuntime version="v4.0"/> |
Geeft een foutbericht weer waarin de gebruiker wordt gevraagd de juiste versie te installeren* | Wordt uitgevoerd op 4 of nieuwere versies | Wordt uitgevoerd op 4 of nieuwere versies |
* Zie initialisatiefouten van .NET Framework voor meer informatie over dit foutbericht en manieren om dit te voorkomen: De gebruikerservaring beheren.
