.NET Framework-implementatiehandleiding voor ontwikkelaars
Notitie
Dit artikel is specifiek voor .NET Framework. Dit geldt niet voor nieuwere implementaties van .NET, waaronder .NET 6 en nieuwere versies.
Dit artikel bevat informatie voor ontwikkelaars die elke versie van .NET Framework willen installeren van .NET Framework 4.5 naar .NET Framework 4.8 met hun apps.
U kunt de herdistribueerbare pakketten en taalpakketten voor .NET Framework downloaden via de downloadpagina's:
- .NET Framework 4.8.1
- .NET Framework 4.8
- .NET Framework 4.7.2
- .NET Framework 4.7.1
- .NET Framework 4.7
- .NET Framework 4.6.2
- .NET Framework 4.6.1
- .NET Framework 4.6
- .NET Framework 4.5.2
- .NET Framework 4.5.1
- .NET Framework 4.5
Belangrijk
.NET Framework-inhoud die eerder digitaal is ondertekend met behulp van certificaten die gebruikmaken van het SHA1-algoritme, wordt buiten gebruik gesteld om de veranderende industriestandaarden te ondersteunen.
Op 26 april 2022 worden de volgende versies van .NET Framework beëindigd: 4.5.2, 4.6 en 4.6.1. Na deze datum worden er geen beveiligingscorrecties, updates en technische ondersteuning meer geboden voor deze versies.
Als u .NET Framework 4.5.2, 4.6 of 4.6.1 gebruikt, werkt u de geïmplementeerde runtime bij naar een recentere versie, zoals .NET Framework 4.6.2, vóór 26 april 2022 om updates en technische ondersteuning te blijven ontvangen.
Bijgewerkte SHA2-ondertekende installatieprogramma's zijn beschikbaar voor .NET Framework 3.5 SP1 en 4.6.2 tot en met 4.8. Zie het SHA1-buitengebruikstellingsplan, het blogbericht over de levenscyclusupdate van .NET 4.5.2, 4.6 en 4.6.1, en de veelgestelde vragen voor meer informatie.
Belangrijke opmerkingen:
Versies van .NET Framework van .NET Framework 4.5.1 tot en met .NET Framework 4.8 zijn in-place updates voor .NET Framework 4.5, wat betekent dat ze dezelfde runtimeversie gebruiken, maar de assemblyversies worden bijgewerkt en nieuwe typen en leden bevatten.
.NET Framework 4.5 en latere versies worden stapsgewijs gebouwd op .NET Framework 4. Wanneer u .NET Framework 4.5 of nieuwere versies installeert op een systeem waarop .NET Framework 4 is geïnstalleerd, worden de versie 4-assembly's vervangen door nieuwere versies.
Als u verwijst naar een out-of-band-pakket van Microsoft in uw app, wordt de assembly opgenomen in het app-pakket.
U moet beheerdersbevoegdheden hebben om .NET Framework 4.5 of nieuwere versies te installeren.
.NET Framework 4.5 is opgenomen in Windows 8 en Windows Server 2012, dus u hoeft deze niet te implementeren met uw app op die besturingssystemen. Op dezelfde manier is .NET Framework 4.5.1 opgenomen in Windows 8.1 en Windows Server 2012 R2. .NET Framework 4.5.2 is niet opgenomen in besturingssystemen. .NET Framework 4.6 is opgenomen in Windows 10, .NET Framework 4.6.1 is opgenomen in Windows 10 November Update en .NET Framework 4.6.2 is opgenomen in Windows 10 Jubileumupdate. .NET Framework 4.7 is opgenomen in Windows 10-makersupdate. .NET Framework 4.7.1 is opgenomen in Windows 10 Fall Creators Update en .NET Framework 4.7.2 is opgenomen in Windows 10 Oktober 2018 Update en Windows 10 April 2018 Update. .NET Framework 4.8 is opgenomen in windows 10 mei 2019 Update en alle latere Windows 10-updates. Zie Systeemvereisten voor een volledige lijst met hardware- en softwarevereisten.
Vanaf .NET Framework 4.5 kunnen uw gebruikers tijdens de installatie een lijst met .NET Framework-apps bekijken en ze eenvoudig sluiten. Dit kan helpen voorkomen dat het systeem opnieuw wordt opgestart door .NET Framework-installaties. Zie Het verminderen van het opnieuw opstarten van het systeem.
Als u .NET Framework 4.5 of hoger verwijdert, worden ook bestaande .NET Framework 4-bestanden verwijderd. Als u terug wilt gaan naar .NET Framework 4, moet u deze opnieuw installeren en eventuele updates. Zie Het installeren van .NET Framework 4.
Het herdistribueerbare .NET Framework 4.5 is op 9 oktober 2012 bijgewerkt om een probleem met betrekking tot een onjuiste tijdstempel op een digitaal certificaat op te lossen, waardoor de digitale handtekening op bestanden die door Microsoft zijn geproduceerd en ondertekend voortijdig verlopen. Als u het herdistribueerbare pakket van .NET Framework 4.5 eerder hebt geïnstalleerd op 16 augustus 2012, raden we u aan uw kopie bij te werken met de meest recente herdistribueerbare versie van de .NET Framework-downloadpagina. Zie Microsoft Security Advisory 2749655 voor meer informatie over dit probleem.
Zie De implementatiehandleiding voor beheerders voor informatie over hoe een systeembeheerder het .NET Framework en de bijbehorende systeemafhankelijkheden in een netwerk kan implementeren.
Implementatieopties voor uw app
Wanneer u klaar bent om uw app te publiceren naar een webserver of een andere centrale locatie, zodat gebruikers deze kunnen installeren, kunt u kiezen uit verschillende implementatiemethoden. Sommige hiervan worden geleverd met Visual Studio. De volgende tabel bevat de implementatieopties voor uw app en geeft het herdistribueerbare pakket van .NET Framework op dat elke optie ondersteunt. Daarnaast kunt u een aangepast installatieprogramma schrijven voor uw app; Zie de sectie .NET Framework-installatie koppelen aan de installatie van uw app voor meer informatie.
Implementatiestrategie voor uw app | Beschikbare implementatiemethoden | .NET Framework herdistribueerbaar voor gebruik |
---|---|---|
Installeren vanaf het web | - InstallAware - InstallShield - WiX-toolset - Handmatige installatie |
Webinstallatieprogramma |
Installeren vanaf schijf | - InstallAware - InstallShield - WiX-toolset - Handmatige installatie |
Offline-installatieprogramma |
Installeren vanuit een local area network (voor bedrijfs-apps) | - ClickOnce | Webinstallatieprogramma (zie ClickOnce voor beperkingen) of offline-installatieprogramma |
Herdistribueerbare pakketten
.NET Framework is beschikbaar in twee herdistribueerbare pakketten: webinstallatieprogramma (bootstrapper) en offline-installatieprogramma (zelfstandig herdistribueerbaar). Alle .NET Framework-downloads worden gehost op de pagina .NET Framework downloaden. In de volgende tabel worden de twee pakketten vergeleken:
Webinstallatieprogramma | Offline-installatieprogramma | |
---|---|---|
Internetverbinding vereist? | Ja | Nr. |
Grootte van downloaden | Kleiner (inclusief installatieprogramma voor alleen doelplatform)* | Groter* |
Taalpakketten | Inbegrepen** | Moet afzonderlijk worden geïnstalleerd, tenzij u het pakket gebruikt dat op alle besturingssystemen is gericht |
Implementatiemethode | Ondersteunt alle methoden: - ClickOnce - InstallAware - InstallShield - Windows Installer XML (WiX) - Handmatige installatie - Aangepaste installatie (keten) |
Ondersteunt alle methoden: - ClickOnce - InstallAware - InstallShield - Windows Installer XML (WiX) - Handmatige installatie - Aangepaste installatie (keten) |
* Het offline-installatieprogramma is groter omdat het de onderdelen voor alle doelplatforms bevat. Wanneer u klaar bent met het instellen, slaat het Windows-besturingssysteem alleen het installatieprogramma op dat is gebruikt. Als het offline-installatieprogramma na de installatie wordt verwijderd, is de gebruikte schijfruimte hetzelfde als de schijfruimte die wordt gebruikt door het webinstallatieprogramma. Als het hulpprogramma dat u gebruikt (bijvoorbeeld InstallAware of InstallShield) om het installatieprogramma van uw app te maken een installatiebestandsmap bevat die na de installatie wordt verwijderd, kan het offline-installatieprogramma automatisch worden verwijderd door het in de installatiemap te plaatsen.
** Als u het webinstallatieprogramma gebruikt met aangepaste instellingen, kunt u standaardtaalinstellingen gebruiken op basis van de Meertalige gebruikersinterface -instelling (MUI) van de gebruiker of een ander taalpakket opgeven met behulp van de /LCID
optie op de opdrachtregel. Zie de sectie Koppelen met behulp van de standaardgebruikersinterface van .NET Framework voor voorbeelden.
Implementatiemethoden
Er zijn vier implementatiemethoden beschikbaar:
U kunt een afhankelijkheid van .NET Framework instellen. U kunt .NET Framework opgeven als een vereiste in de installatie van uw app, met behulp van een van de volgende methoden:
ClickOnce-implementatie gebruiken (beschikbaar in Visual Studio)
Een InstallAware-project maken (gratis editie beschikbaar voor Visual Studio-gebruikers)
Een InstallShield-project maken (beschikbaar met Visual Studio)
U kunt uw gebruikers vragen .NET Framework handmatig te installeren.
U kunt het .NET Framework-installatieproces koppelen (opnemen) in de installatie van uw app en bepalen hoe u de .NET Framework-installatie-ervaring wilt afhandelen:
Gebruik de standaardgebruikersinterface. Laat het .NET Framework-installatieprogramma de installatie-ervaring bieden.
Pas de gebruikersinterface aan om een uniforme installatie-ervaring te bieden en de voortgang van de .NET Framework-installatie te bewaken.
Deze implementatiemethoden worden uitgebreid besproken in de volgende secties.
Een afhankelijkheid instellen op .NET Framework
Als u ClickOnce, InstallAware, InstallShield of WiX gebruikt om uw app te implementeren, kunt u een afhankelijkheid van .NET Framework toevoegen, zodat deze kan worden geïnstalleerd als onderdeel van uw app.
ClickOnce-implementatie
ClickOnce-implementatie is beschikbaar voor projecten die zijn gemaakt met Visual Basic en Visual C#, maar deze is niet beschikbaar voor Visual C++.
In Visual Studio kiest u ClickOnce-implementatie en voegt u een afhankelijkheid toe van .NET Framework:
Open het app-project dat u wilt publiceren.
Open in Solution Explorer het snelmenu voor uw project en kies Eigenschappen.
Kies het deelvenster Publiceren .
Kies de knop Vereisten .
Controleer in het dialoogvenster Vereisten of het selectievakje Installatieprogramma maken voor het installeren van vereiste onderdelen is ingeschakeld.
Zoek en selecteer in de lijst met vereisten de versie van .NET Framework die u hebt gebruikt om uw project te bouwen.
Kies een optie om de bronlocatie voor de vereisten op te geven en kies vervolgens OK.
Als u een URL opgeeft voor de .NET Framework-downloadlocatie, kunt u de .NET Framework-downloadpagina of een eigen site opgeven. Als u het herdistribueerbare pakket op uw eigen server plaatst, moet dit het offline-installatieprogramma zijn en niet het webinstallatieprogramma. U kunt alleen een koppeling maken naar het webinstallatieprogramma op de downloadpagina van .NET Framework. De URL kan ook een schijf opgeven waarop uw eigen app wordt gedistribueerd.
Kies OK in het dialoogvenster Eigenschappenpagina's.
InstallAware-implementatie
InstallAware bouwt Windows-app (APPX), Windows Installer (MSI), Native Code (EXE) en App-V-pakketten (Application Virtualization) vanuit één bron. Voeg eenvoudig elke versie van het .NET Framework in uw installatie toe en pas eventueel de installatie aan door de standaardscripts te bewerken. InstallAware installeert bijvoorbeeld certificaten vooraf in Windows 7, zonder dat de installatie van .NET Framework 4.7 mislukt. Zie de website InstallAware voor Windows Installer voor meer informatie over InstallAware.
InstallShield-implementatie
InstallShield bouwt Windows-app-pakketten (MSIX, APPX), Windows Installer-pakketten (MSI) en EXE-installatieprogramma's (Native Code). InstallShield biedt ook Visual Studio-integratie. Zie de InstallShield-website voor meer informatie.
Implementatie van Windows Installer XML (WiX)
De Windows Installer XML-toolset (WiX) bouwt Windows-installatiepakketten op basis van XML-broncode. WiX ondersteunt een opdrachtregelomgeving die kan worden geïntegreerd in uw buildprocessen om MSI- en MSM-installatiepakketten te bouwen. Met behulp van WiX kunt u het .NET Framework opgeven als een vereiste of een chainer maken om de implementatie-ervaring van .NET Framework volledig te beheren. Zie de windows Installer XML-hulpprogrammasetwebsite (WiX) voor meer informatie over WiX.
.NET Framework handmatig installeren
In sommige situaties is het mogelijk niet praktisch om .NET Framework automatisch te installeren met uw app. In dat geval kunt u gebruikers .NET Framework zelf laten installeren. Het herdistribueerbare pakket is beschikbaar in twee pakketten. Geef in het installatieproces instructies op voor hoe gebruikers .NET Framework moeten vinden en installeren.
Koppel de .NET Framework-installatie aan de installatie van uw app
Als u een aangepast installatieprogramma voor uw app maakt, kunt u het .NET Framework-installatieproces koppelen (opnemen) in het installatieproces van uw app. Koppelen biedt twee UI-opties voor de .NET Framework-installatie:
Gebruik de standaardgebruikersinterface van het .NET Framework-installatieprogramma.
Maak een aangepaste gebruikersinterface voor de .NET Framework-installatie voor consistentie met het installatieprogramma van uw app.
Met beide methoden kunt u het webinstallatieprogramma of het offline-installatieprogramma gebruiken. Elk pakket heeft zijn voordelen:
Als u het webinstallatieprogramma gebruikt, bepaalt het installatieproces van .NET Framework welk installatiepakket vereist is en downloadt en installeert u alleen dat pakket vanaf het web.
Als u het offline-installatieprogramma gebruikt, kunt u de volledige set .NET Framework-installatiepakketten opnemen met uw herdistributiemedia, zodat uw gebruikers tijdens de installatie geen extra bestanden van internet hoeven te downloaden.
Koppelen met behulp van de standaardinterface van .NET Framework
Als u het .NET Framework-installatieproces op de achtergrond wilt koppelen en het .NET Framework-installatieprogramma de gebruikersinterface wilt bieden, voegt u de volgende opdracht toe aan uw installatieprogramma:
<.NET Framework redistributable> /q /norestart /ChainingPackage <PackageName>
Als uw uitvoerbare programma bijvoorbeeld is Contoso.exe en u het .NET Framework 4.5 offline herdistribueerbare pakket wilt installeren, gebruikt u de opdracht:
dotNetFx45_Full_x86_x64.exe /q /norestart /ChainingPackage Contoso
U kunt extra opdrachtregelopties gebruiken om de installatie aan te passen. Voorbeeld:
Als u gebruikers een manier wilt bieden om actieve .NET Framework-apps te sluiten om het opnieuw opstarten van het systeem te minimaliseren, stelt u de passieve modus in en gebruikt u de
/showrmui
optie als volgt:dotNetFx45_Full_x86_x64.exe /norestart /passive /showrmui /ChainingPackage Contoso
Met deze opdracht kan Restart Manager een berichtvak weergeven waarmee gebruikers .NET Framework-apps kunnen sluiten voordat ze .NET Framework installeren.
Als u het webinstallatieprogramma gebruikt, kunt u de
/LCID
optie gebruiken om een taalpakket op te geven. Als u bijvoorbeeld het webinstallatieprogramma van .NET Framework 4.5 wilt koppelen aan uw Contoso-installatieprogramma en het Japanse taalpakket wilt installeren, voegt u de volgende opdracht toe aan het installatieproces van uw app:dotNetFx45_Full_setup.exe /q /norestart /ChainingPackage Contoso /LCID 1041
Als u de
/LCID
optie weglaat, installeert setup het taalpakket dat overeenkomt met de MUI-instelling van de gebruiker.Notitie
Verschillende taalpakketten kunnen verschillende releasedatums hebben. Als het taalpakket dat u opgeeft niet beschikbaar is in het downloadcentrum, wordt het .NET Framework geïnstalleerd zonder het taalpakket. Als .NET Framework al op de computer van de gebruiker is geïnstalleerd, wordt alleen het taalpakket geïnstalleerd.
Zie de sectie Opdrachtregelopties voor een volledige lijst met opties.
Zie de sectie Retourcodes voor algemene retourcodes .
Koppelen met behulp van een aangepaste gebruikersinterface
Als u een aangepast installatiepakket hebt, kunt u de installatie van .NET Framework op de achtergrond starten en bijhouden terwijl u uw eigen weergave van de voortgang van de installatie weergeeft. Als dit het geval is, moet u ervoor zorgen dat uw code het volgende behandelt:
Controleer op hardware- en softwarevereisten voor .NET Framework.
Detecteren of de juiste versie van .NET Framework al is geïnstalleerd op de computer van de gebruiker.
Belangrijk
Als u wilt bepalen of de juiste versie van .NET Framework al is geïnstalleerd, moet u controleren of uw doelversie of een latere versie is geïnstalleerd, niet of uw doelversie is geïnstalleerd. Met andere woorden, u moet evalueren of de releasesleutel die u ophaalt uit het register groter is dan of gelijk is aan de releasesleutel van uw doelversie, niet of deze gelijk is aan de releasesleutel van uw doelversie.
Detecteren of de taalpakketten al zijn geïnstalleerd op de computer van de gebruiker.
Als u de implementatie wilt beheren, start en volgt u het installatieproces van .NET Framework op de achtergrond (zie Procedure: Voortgang ophalen van het .NET Framework 4.5-installatieprogramma).
Als u het offline-installatieprogramma implementeert, koppelt u de taalpakketten afzonderlijk.
Pas de implementatie aan met behulp van opdrachtregelopties. Als u bijvoorbeeld het webinstallatieprogramma van .NET Framework koppelt, maar u het standaardtaalpakket wilt overschrijven, gebruikt u de
/LCID
optie, zoals beschreven in de vorige sectie.
.NET Framework detecteren
Het .NET Framework-installatieprogramma schrijft registersleutels wanneer de installatie is geslaagd. U kunt testen of .NET Framework 4.5 of hoger is geïnstalleerd door de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full
map in het register te controleren op een waarde met de DWORD
naam Release
. (Houd er rekening mee dat 'NET Framework Setup' niet begint met een punt.) Het bestaan van deze sleutel geeft aan dat .NET Framework 4.5 of een latere versie op die computer is geïnstalleerd. De waarde van Release
geeft aan welke versie van .NET Framework is geïnstalleerd.
Belangrijk
Controleer of een waarde groter dan of gelijk is aan de waarde van het releasewoord wanneer u probeert te detecteren of een specifieke versie aanwezig is.
Versie | Waarde van de release-DWORD |
---|---|
.NET Framework 4.8.1 | 533325 |
.NET Framework 4.8 geïnstalleerd op Windows 10 Mei 2020 Update en Windows 10 Oktober 2020 Update | 528372 |
.NET Framework 4.8 geïnstalleerd op Windows 10 Mei 2019 Update en Windows 10 November 2019 Update | 528040 |
.NET Framework 4.8 geïnstalleerd op alle besturingssysteemversies anders dan de vermelde Windows 10 Update-versies | 528049 |
.NET Framework 4.7.2 geïnstalleerd op Windows 10 april 2018 Update en op Windows Server, versie 1803 | 461808 |
.NET Framework 4.7.2 geïnstalleerd op alle versies van het besturingssysteem, met uitzondering van Windows 10 April 2018 Update en Windows Server, versie 1803. Dit omvat windows 10 oktober 2018 Update. | 461814 |
.NET Framework 4.7.1 geïnstalleerd op Windows 10 Fall Creators Update en op Windows Server, versie 1709 | 461308 |
.NET Framework 4.7.1 geïnstalleerd op alle besturingssysteemversies anders dan Windows 10 Fall Creators Update en Windows Server, versie 1709 | 461310 |
.NET Framework 4.7 geïnstalleerd op Windows 10-makersupdate | 460798 |
.NET Framework 4.7 geïnstalleerd op alle besturingssysteemversies anders dan Windows 10-makersupdate | 460805 |
.NET Framework 4.6.2 geïnstalleerd op Windows 10 Jubileumeditie en op Windows Server 2016 | 394802 |
.NET Framework 4.6.2 geïnstalleerd op alle besturingssysteemversies anders dan Windows 10 Jubileumeditie en Windows Server 2016 | 394806 |
.NET Framework 4.6.1 geïnstalleerd op Windows 10 November Update | 394254 |
.NET Framework 4.6.1 geïnstalleerd op alle besturingssysteemversies anders dan Windows 10 November Update | 394271 |
.NET Framework 4.6 geïnstalleerd op Windows 10 | 393295 |
.NET Framework 4.6 geïnstalleerd op alle besturingssysteemversies anders dan Windows 10 | 393297 |
.NET Framework 4.5.2 | 379893 |
.NET Framework 4.5.1 geïnstalleerd met Windows 8.1 of Windows Server 2012 R2 | 378675 |
.NET Framework 4.5.1 geïnstalleerd op Windows 8, Windows 7 | 378758 |
.NET Framework 4.5 | 378389 |
Taalpakketten detecteren
U kunt testen of een specifiek taalpakket is geïnstalleerd door de map HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\LCID in het register te controleren op een DWORD-waarde met de naam Release
. (Houd er rekening mee dat 'NET Framework Setup' niet begint met een punt.) LCID geeft een landinstellings-id op. Zie ondersteunde talen voor een lijst met deze talen .
Als u bijvoorbeeld wilt detecteren of het volledige Japanse taalpakket (LCID=1041) is geïnstalleerd, haalt u de volgende benoemde waarde op uit het register:
Weergegeven als | |
---|---|
Code | HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\1041 |
Invoer | Vrijgeven |
Type | DWORD |
Als u wilt bepalen of de definitieve versie van een taalpakket is geïnstalleerd voor een bepaalde versie van .NET Framework van 4.5 tot en met 4.7.2, controleert u de waarde van de DWORD-waarde releasesleutel die in de vorige sectie is beschreven, .NET Framework detecteren.
De taalpakketten koppelen aan de installatie van uw app
.NET Framework biedt een set zelfstandige uitvoerbare bestanden voor taalpakketten die gelokaliseerde resources voor specifieke culturen bevatten. De taalpakketten zijn beschikbaar op de .NET Framework-downloadpagina's:
- .NET Framework 4.8.1
- .NET Framework 4.8
- .NET Framework 4.7.2
- .NET Framework 4.7.1
- .NET Framework 4.7
- .NET Framework 4.6.2
- .NET Framework 4.6.1
- .NET Framework 4.6
- .NET Framework 4.5.2
- .NET Framework 4.5.1
- .NET Framework 4.5
Belangrijk
De taalpakketten bevatten niet de .NET Framework-onderdelen die nodig zijn om een app uit te voeren. U moet .NET Framework installeren met behulp van het web- of offline-installatieprogramma voordat u een taalpakket installeert.
Vanaf .NET Framework 4.5.1 hebben de pakketnamen de vorm NDP-KB-x86-x64-AllOS<>>number
version
<-<culture
>.exe, waarbij version
het versienummer van .NET Framework is, number
een Microsoft Knowledge Base-artikelnummer is en culture
een land/regio opgeeft. Een voorbeeld van een van deze pakketten is NDP452-KB2901907-x86-x64-AllOS-JPN.exe
. Pakketnamen worden eerder in dit artikel vermeld in de sectie Redistributable Packages .
Als u een taalpakket wilt installeren met het offline-installatieprogramma van .NET Framework, moet u het koppelen aan de installatie van uw app. Als u bijvoorbeeld .NET Framework 4.5.1 offline-installatieprogramma wilt implementeren met het Japanse taalpakket, gebruikt u de volgende opdracht:
NDP451-KB2858728-x86-x64-AllOS-JPN.exe /q /norestart /ChainingPackage <ProductName>
U hoeft de taalpakketten niet te koppelen als u het webinstallatieprogramma gebruikt; Setup installeert het taalpakket dat overeenkomt met de MUI-instelling van de gebruiker. Als u een andere taal wilt installeren, kunt u de /LCID
optie gebruiken om een taalpakket op te geven.
Zie de sectie Opdrachtregelopties voor een volledige lijst met opdrachtregelopties.
Probleemoplossing
Retourcodes
De volgende tabel bevat de meest voorkomende retourcodes voor het herdistribueerbare installatieprogramma van .NET Framework. De retourcodes zijn hetzelfde voor alle versies van het installatieprogramma. Zie de volgende sectie voor koppelingen naar gedetailleerde informatie.
Retourcode | Beschrijving |
---|---|
0 | De installatie is voltooid. |
1602 | De gebruiker heeft de installatie geannuleerd. |
1603 | Er is een fatale fout opgetreden tijdens de installatie. |
1641 | Opnieuw opstarten is vereist om de installatie te voltooien. Dit bericht geeft aan dat het is gelukt. |
3010 | Opnieuw opstarten is vereist om de installatie te voltooien. Dit bericht geeft aan dat het is gelukt. |
5100 | De computer van de gebruiker voldoet niet aan de systeemvereisten. |
Foutcodes downloaden
Zie de volgende inhoud:
Overige foutcodes
Zie de volgende inhoud:
.NET Framework verwijderen
Vanaf Windows 8 kunt u .NET Framework 4.5 of hoger verwijderen met behulp van Windows-functies in- en uitschakelen in Configuratiescherm. In oudere versies van Windows kunt u .NET Framework 4.5 of hoger verwijderen met behulp van Programma's toevoegen of verwijderen in Configuratiescherm.
Belangrijk
Voor Windows 7- en eerdere besturingssystemen verwijdert u .NET Framework 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 of 4.8.1 herstelt geen .NET Framework 4.5-bestanden en het verwijderen van .NET Framework 4.5 herstelt geen .NET Framework 4-bestanden. Als u terug wilt gaan naar de oudere versie, moet u deze opnieuw installeren en eventuele updates ervan.
Bijlage
Opdrachtregelopties
De volgende tabel bevat opties die u kunt opnemen wanneer u .NET Framework 4.5 opnieuw kunt koppelen aan de installatie van uw app.
Optie | Omschrijving |
---|---|
/CEIPConsent | Overschrijft het standaardgedrag en stuurt anonieme feedback naar Microsoft om toekomstige implementatie-ervaringen te verbeteren. Deze optie kan alleen worden gebruikt als het installatieprogramma om toestemming vraagt en als de gebruiker toestemming verleent om anonieme feedback naar Microsoft te verzenden. |
/chainingpackage packageName |
Hiermee geeft u de naam op van het uitvoerbare bestand dat de keten uitvoert. Deze informatie wordt naar Microsoft verzonden als anonieme feedback om toekomstige implementatie-ervaringen te verbeteren. Als de pakketnaam spaties bevat, gebruikt u dubbele aanhalingstekens als scheidingstekens; bijvoorbeeld: /chainingpackage "Publishing van Foutberichten". Zie Voortgangsgegevens ophalen uit een installatiepakket voor een voorbeeld van een ketenpakket. |
/LCID LCID waarbij LCID een landinstellings-id wordt opgegeven (zie ondersteunde talen) |
Hiermee installeert u het taalpakket dat is opgegeven door LCID en dwingt u af dat de weergegeven gebruikersinterface in die taal wordt weergegeven, tenzij de stille modus is ingesteld.Voor het webinstallatieprogramma installeert deze optie het taalpakket vanaf het web. Opmerking: Gebruik deze optie alleen met het webinstallatieprogramma. |
/log file | folder |
Hiermee geeft u de locatie van het logboekbestand. De standaardmap is de tijdelijke map voor het proces en de standaardbestandsnaam is gebaseerd op het pakket. Als de bestandsextensie is .txt, wordt er een tekstlogboek geproduceerd. Als u een andere extensie of geen extensie opgeeft, wordt er een HTML-logboek gemaakt. |
/msioptions | Hiermee geeft u opties worden doorgegeven voor .msi- en MSP-items; bijvoorbeeld: /msioptions "PROPERTY1='Value'" . |
/norestart | Hiermee voorkomt u dat het installatieprogramma automatisch opnieuw wordt opgestart. Als u deze optie gebruikt, moet de keten-app de retourcode vastleggen en opnieuw opstarten afhandelen (zie Voortgangsgegevens ophalen uit een installatiepakket). |
/passief | Hiermee stelt u de passieve modus in. Geeft de voortgangsbalk weer om aan te geven dat de installatie wordt uitgevoerd, maar geeft geen prompts of foutberichten weer voor de gebruiker. In deze modus moet het ketenpakket, wanneer het gekoppeld door een installatieprogramma, retourcodes verwerken. |
/pijp | Hiermee maakt u een communicatiekanaal om een ketenpakket in staat te stellen voortgang te krijgen. |
/promptrestart | Alleen passieve modus, als het installatieprogramma opnieuw moet worden opgestart, wordt de gebruiker gevraagd. Voor deze optie is gebruikersinteractie vereist als opnieuw opstarten is vereist. |
/q | Hiermee stelt u de stille modus in. |
/repareren | Hiermee activeert u de herstelfunctionaliteit. |
/serialdownload | Hiermee wordt de installatie alleen uitgevoerd nadat het pakket is gedownload. |
/showfinalerror | Hiermee stelt u de passieve modus in. Geeft alleen fouten weer als de installatie niet is geslaagd. Voor deze optie is gebruikersinteractie vereist als de installatie niet lukt. |
/showrmui | Alleen gebruikt met de /passieve optie. Geeft een berichtvenster weer waarin gebruikers wordt gevraagd om .NET Framework-apps te sluiten die momenteel worden uitgevoerd. Dit berichtvak gedraagt zich hetzelfde in de passieve en niet-passieve modus. |
/uninstall | Hiermee verwijdert u het herdistribueerbare .NET Framework. |
Ondersteunde talen
De volgende tabel bevat .NET Framework-taalpakketten die beschikbaar zijn voor .NET Framework 4.5 en nieuwere versies.
LCID | Taal – land/regio | Cultuur |
---|---|---|
1025 | Arabisch - Saoedi-Arabië | ar |
1028 | Chinees ( traditioneel) | zh-Hant |
1029 | Tsjechisch | cs |
1030 | Deens | da |
1031 | Duits (Duitsland) | de |
1032 | Grieks | el |
1035 | Fins | fi |
1036 | Frans (Frankrijk) | fr |
1037 | Hebreeuws | he |
1038 | Hongaars | hu |
1040 | Italiaans (Italië) | het |
1041 | Japans | ja |
1042 | Koreaans | ko |
1043 | Nederlands (Nederland) | nl |
1044 | Noors (Bokmål) | nee |
1045 | Pools | pl |
1046 | Portugees (Brazilië) | pt-BR |
1049 | Russisch | ru |
1053 | Zweeds | sv |
1055 | Turks | tr |
2052 | Chinees ( vereenvoudigd) | zh-Hans |
2070 | Portugees (Portugal) | pt-PT |
3082 | Spaans - Spanje (moderne sortering) | es |
Zie ook
- Implementatiehandleiding voor beheerders
- Systeemvereisten
- .NET Framework voor ontwikkelaars installeren
- Problemen met geblokkeerde .NET Framework-installaties en -verwijderingen oplossen
- Systeem opnieuw opstarten verminderen tijdens .NET Framework 4.5-installaties
- Procedure: Voortgang ophalen van het .NET Framework 4.5-installatieprogramma
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort: Gedurende 2024 worden GitHub Issues uitgefaseerd als het feedbackmechanisme voor inhoud. Dit wordt vervangen door een nieuw feedbacksysteem. Ga voor meer informatie naar:Feedback verzenden en bekijken voor