Distributionsguide för .NET Framework för utvecklare

Den här artikeln innehåller information för utvecklare som vill installera valfri version av .NET Framework från .NET Framework 4.5 till .NET Framework 4.8 med sina appar.

Du kan ladda ned de omdistribuerbara paketen och språkpaketen för .NET Framework från nedladdningssidorna:

• .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

Viktiga kommentarer:

• Versioner av .NET Framework från .NET Framework 4.5.1 till .NET Framework 4.8 är på plats-uppdateringar av .NET Framework 4.5, vilket innebär att de använder samma körningsversion, men sammansättningsversionerna uppdateras och innehåller nya typer och medlemmar.

• .NET Framework 4.5 och senare versioner skapas stegvis på .NET Framework 4. När du installerar .NET Framework 4.5 eller senare versioner på ett system som har .NET Framework 4 installerat ersätts version 4-sammansättningarna med nyare versioner.

• Om du refererar till ett Microsoft out-of-band-paket i din app inkluderas sammansättningen i apppaketet.

• Du måste ha administratörsbehörighet för att kunna installera .NET Framework 4.5 eller senare versioner.

• .NET Framework 4.5 ingår i Windows 8 och Windows Server 2012, så du behöver inte distribuera det med din app på dessa operativsystem. På samma sätt ingår .NET Framework 4.5.1 i Windows 8.1 och Windows Server 2012 R2. .NET Framework 4.5.2 ingår inte i några operativsystem. .NET Framework 4.6 ingår i Windows 10, .NET Framework 4.6.1 ingår i Windows 10 November Update och .NET Framework 4.6.2 ingår i Windows 10 Anniversary Update. .NET Framework 4.7 ingår i Windows 10 ispravka za kreativne, .NET Framework 4.7.1 ingår i Windows 10 Fall Creators Update och .NET Framework 4.7.2 ingår i Ispravka za Windows 10 iz oktobra 2018. och Windows 10 April 2018 Update. .NET Framework 4.8 ingår i Ispravka za Windows 10 iz maja 2019. och alla senare Windows 10-uppdateringar. En fullständig lista över maskinvaru- och programvarukrav finns i Systemkrav.

• Från och med .NET Framework 4.5 kan användarna visa en lista över hur de kör .NET Framework-appar under installationen och enkelt stänga dem. Detta kan bidra till att undvika systemomstarter som orsakas av .NET Framework-installationer. Se Minska omstarter av systemet.

• Om du avinstallerar .NET Framework 4.5 eller senare tas även befintliga .NET Framework 4-filer bort. Om du vill gå tillbaka till .NET Framework 4 måste du installera om det och eventuella uppdateringar av det. Se Installera .NET Framework 4.

• Omdistribuerbar .NET Framework 4.5 uppdaterades den 9 oktober 2012 för att korrigera ett problem som rör en felaktig tidsstämpel på ett digitalt certifikat, vilket gjorde att den digitala signaturen på filer som skapats och signerats av Microsoft upphör att gälla i förtid. Om du tidigare har installerat .NET Framework 4.5-omdistribuerbart paket daterat den 16 augusti 2012 rekommenderar vi att du uppdaterar kopian med den senaste omdistribuerbara versionen från nedladdningssidan för .NET Framework. Mer information om det här problemet finns i Microsoft Security Advisory 2749655.

Information om hur en systemadministratör kan distribuera .NET Framework och dess systemberoenden i ett nätverk finns i Distributionsguide för administratörer.

Distributionsalternativ för din app

När du är redo att publicera appen på en webbserver eller annan central plats så att användarna kan installera den kan du välja mellan flera distributionsmetoder. Vissa av dessa tillhandahålls med Visual Studio. I följande tabell visas distributionsalternativen för din app och det .NET Framework-omdistribuerbara paketet som stöder varje alternativ. Utöver dessa kan du skriva ett anpassat installationsprogram för din app. Mer information finns i avsnittet Chaining the .NET Framework Installation to Your App's Setup.

Omdistribuerbara paket

.NET Framework är tillgängligt i två omdistribuerbara paket: webbinstallationsprogram (bootstrapper) och offlineinstallationsprogram (fristående omdistribuerbart). Alla .NET Framework-nedladdningar finns på sidan Ladda ned .NET Framework. I följande tabell jämförs de två paketen:

* Installationsprogrammet offline är större eftersom det innehåller komponenterna för alla målplattformar. När du har slutfört installationen cachelagrar Windows-operativsystemet bara installationsprogrammet som användes. Om offlineinstallationsprogrammet tas bort efter installationen är diskutrymmet som används samma som det som används av webbinstallationsprogrammet. Om verktyget du använder (till exempel InstallAware eller InstallShield) för att skapa appens installationsprogram innehåller en installationsfilmapp som tas bort efter installationen, kan offlineinstallationsprogrammet tas bort automatiskt genom att det placeras i installationsmappen.

** Om du använder webbinstallationsprogrammet med anpassad installation kan du använda standardspråkinställningar baserat på användarens inställning för višejezički korisnički interfejs (MUI) eller ange ett annat språkpaket med hjälp /LCID av alternativet på kommandoraden. Se avsnittet Chaining by Using the Default .NET Framework UI for examples (Länka med hjälp av standardgränssnittet för .NET Framework).

Distributionsmetoder

Fyra distributionsmetoder är tillgängliga:

• Du kan ange ett beroende av .NET Framework. Du kan ange .NET Framework som en förutsättning i appens installation med någon av följande metoder:

  • Använda ClickOnce-distribution (tillgängligt med Visual Studio)

  • Skapa ett InstallAware-projekt (kostnadsfri utgåva tillgänglig för Visual Studio-användare)

  • Skapa ett InstallShield-projekt (tillgängligt med Visual Studio)

  • Använda Windows Installer XML-verktygsuppsättningen (WiX)

• Du kan be användarna att installera .NET Framework manuellt.

• Du kan länka (inkludera) konfigurationsprocessen för .NET Framework i appens konfiguration och bestämma hur du vill hantera .NET Framework-installationsmiljön:

  • Använd standardgränssnittet. Låt installationsprogrammet för .NET Framework tillhandahålla installationsupplevelsen.

  • Anpassa användargränssnittet för att presentera en enhetlig installationsupplevelse och för att övervaka installationsframtiden för .NET Framework.

Dessa distributionsmetoder beskrivs i detalj i följande avsnitt.

Ange ett beroende av .NET Framework

Om du använder ClickOnce, InstallAware, InstallShield eller WiX för att distribuera din app kan du lägga till ett beroende av .NET Framework så att det kan installeras som en del av din app.

ClickOnce-distribution

ClickOnce-distributionen är tillgänglig för projekt som skapas med Visual Basic och Visual C#, men den är inte tillgänglig för Visual C++.

I Visual Studio väljer du ClickOnce-distribution och lägger till ett beroende av .NET Framework:

1. Öppna det appprojekt som du vill publicera.

2. I Istraživač rešenja öppnar du snabbmenyn för projektet och väljer sedan Egenskaper.

3. Välj fönstret Publicera .

4. Välj knappen Förutsättningar.

5. I dialogrutan Förutsättningar kontrollerar du att kryssrutan Skapa installationsprogram för att installera nödvändiga komponenter är markerad.

6. Leta upp och välj den version av .NET Framework som du har använt för att skapa projektet i listan med förhandskrav.

7. Välj ett alternativ för att ange källplatsen för förhandskraven och välj sedan OK.

   Om du anger en URL för nedladdningsplatsen för .NET Framework kan du ange antingen nedladdningssidan för .NET Framework eller en egen webbplats. Om du placerar det omdistribuerbara paketet på din egen server måste det vara installationsprogrammet offline och inte webbinstallationsprogrammet. Du kan bara länka till webbinstallationsprogrammet på nedladdningssidan för .NET Framework. URL:en kan också ange en skiva där din egen app distribueras.

8. I dialogrutan Egenskapssidor väljer du OK.

InstallAware-distribution

InstallAware bygger Windows-apppaket (APPX), Windows Installer (MSI), Native Code (EXE) och App-V (Application Virtualization) från en enda källa. Inkludera enkelt valfri version av .NET Framework i konfigurationen, om du vill kan du anpassa installationen genom att redigera standardskripten. Till exempel installerar InstallAware förinstallerar certifikat på Windows 7, utan vilka installationen av .NET Framework 4.7 misslyckas. Mer information om InstallAware finns på webbplatsen InstallAware för Windows Installer .

InstallShield-distribution

InstallShield skapar Windows-apppaket (MSIX, APPX), Windows Installer-paket (MSI) och installationsprogram för inbyggd kod (EXE). InstallShield tillhandahåller även Visual Studio-integrering. Mer information finns på webbplatsen InstallShield .

Windows Installer XML-distribution (WiX)

Windows Installer XML-verktygsuppsättningen (WiX) skapar Windows-installationspaket från XML-källkod. WiX stöder en kommandoradsmiljö som kan integreras i dina byggprocesser för att skapa MSI- och MSM-installationspaket. Genom att använda WiX kan du ange .NET Framework som en förutsättning eller skapa en kedjekedja för att fullständigt kontrollera distributionsupplevelsen för .NET Framework. Mer information om WiX finns på webbplatsen för Windows Installer XML(WiX) toolset .

Installera .NET Framework manuellt

I vissa situationer kan det vara opraktiskt att automatiskt installera .NET Framework med din app. I så fall kan du låta användarna installera .NET Framework själva. Det omdistribuerbara paketet finns i två paket. I konfigurationsprocessen anger du instruktioner för hur användare ska hitta och installera .NET Framework.

Länka .NET Framework-installationen till appens konfiguration

Om du skapar ett anpassat installationsprogram för din app kan du länka (inkludera) .NET Framework-konfigurationsprocessen i appens installationsprocess. Länkning innehåller två gränssnittsalternativ för .NET Framework-installationen:

• Använd standardgränssnittet som tillhandahålls av .NET Framework-installationsprogrammet.

• Skapa ett anpassat användargränssnitt för .NET Framework-installationen för konsekvens med appens installationsprogram.

Med båda metoderna kan du använda antingen webbinstallationsprogrammet eller installationsprogrammet offline. Varje paket har sina fördelar:

• Om du använder webbinstallationsprogrammet bestämmer .NET Framework-installationsprocessen vilket installationspaket som krävs och hämtar och installerar endast paketet från webben.

• Om du använder offlineinstallationsprogrammet kan du inkludera den fullständiga uppsättningen .NET Framework-installationspaket med ditt omdistributionsmedia så att användarna inte behöver ladda ned ytterligare filer från webben under installationen.

Länka med hjälp av standardgränssnittet för .NET Framework

Om du vill länka installationsprocessen för .NET Framework tyst och låta installationsprogrammet för .NET Framework tillhandahålla användargränssnittet lägger du till följande kommando i installationsprogrammet:

<.NET Framework redistributable> /q /norestart /ChainingPackage <PackageName>

Om ditt körbara program till exempel är Contoso.exe och du vill installera .NET Framework 4.5 offline omdistribuerbart paket utan att behöva installera det, använder du kommandot:

dotNetFx45_Full_x86_x64.exe /q /norestart /ChainingPackage Contoso

Du kan använda ytterligare kommandoradsalternativ för att anpassa installationen. Till exempel:

• Om du vill ge användarna ett sätt att stänga .NET Framework-appar som körs för att minimera omstarter av systemet anger du passivt läge och använder /showrmui alternativet på följande sätt:

  dotNetFx45_Full_x86_x64.exe /norestart /passive /showrmui /ChainingPackage Contoso

  Med det här kommandot kan Restart Manager visa en meddelanderuta som ger användarna möjlighet att stänga .NET Framework-appar innan de installerar .NET Framework.

• Om du använder webbinstallationsprogrammet kan du använda /LCID alternativet för att ange ett språkpaket. Om du till exempel vill länka .NET Framework 4.5-webbinstallationsprogrammet till ditt Contoso-installationsprogram och installera det japanska språkpaketet lägger du till följande kommando i appens installationsprocess:

  dotNetFx45_Full_setup.exe /q /norestart /ChainingPackage Contoso /LCID 1041

  Om du utelämnar alternativet /LCID installeras språkpaketet som matchar användarens MUI-inställning.

  Kommentar

  Olika språkpaket kan ha olika utgivningsdatum. Om det språkpaket som du anger inte är tillgängligt i nedladdningscentret installerar installationen .NET Framework utan språkpaketet. Om .NET Framework redan är installerat på användarens dator installeras endast språkpaketet.

En fullständig lista över alternativ finns i avsnittet Kommandoradsalternativ .

Vanliga returkoder finns i avsnittet Returkoder .

Länka med hjälp av ett anpassat användargränssnitt

Om du har ett anpassat konfigurationspaket kanske du vill starta och spåra .NET Framework-installationen tyst samtidigt som du visar din egen vy över installationsförloppet. Om så är fallet kontrollerar du att koden omfattar följande:

• Sök efter maskinvaru- och programvarukrav för .NET Framework.

• Identifiera om rätt version av .NET Framework redan är installerad på användarens dator.

  Viktigt!

  När du avgör om rätt version av .NET Framework redan är installerad bör du kontrollera om målversionen eller en senare version är installerad, inte om målversionen är installerad. Med andra ord bör du utvärdera om versionsnyckeln som du hämtar från registret är större än eller lika med versionsnyckeln för målversionen, inte om den är lika med versionsnyckeln för målversionen.

• Identifiera om språkpaketen redan är installerade på användarens dator.

• Om du vill styra distributionen startar du tyst och spårar installationsprocessen för .NET Framework (se Så här: Hämta förlopp från installationsprogrammet för .NET Framework 4.5).

• Om du distribuerar offlineinstallationsprogrammet kedjar du språkpaketen separat.

• Anpassa distributionen med hjälp av kommandoradsalternativ. Om du till exempel kopplar samman .NET Framework-webbinstallationsprogrammet, men vill åsidosätta standardspråkpaketet, använder /LCID du alternativet enligt beskrivningen i föregående avsnitt.

• Felsök.

Identifiera .NET Framework

Installationsprogrammet för .NET Framework skriver registernycklar när installationen lyckas. Du kan testa om .NET Framework 4.5 eller senare har installerats genom att kontrollera HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full mappen i registret efter ett DWORD värde med namnet Release. (Observera att "NET Framework-installationen" inte börjar med en punkt.) Förekomsten av den här nyckeln anger att .NET Framework 4.5 eller en senare version har installerats på den datorn. Värdet Release för anger vilken version av .NET Framework som är installerad.

Identifiera språkpaket

Du kan testa om ett specifikt språkpaket har installerats genom att kontrollera mappen HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\LCID i registret för ett DWORD-värde med namnet Release. (Observera att "NET Framework-installationen" inte börjar med en punkt.) LCID anger en språkidentifierare. En lista över dessa finns i språk som stöds.

Om du till exempel vill identifiera om det fullständiga japanska språkpaketet (LCID=1041) är installerat hämtar du följande namngivna värde från registret:

Om du vill avgöra om den slutliga versionen av ett språkpaket är installerad för en viss version av .NET Framework från 4.5 till 4.7.2 kontrollerar du värdet för DWORD-värdet för RELEASE-nyckeln som beskrivs i föregående avsnitt Identifiera .NET Framework.

Länka språkpaketen till din appkonfiguration

.NET Framework tillhandahåller en uppsättning körbara filer med fristående språkpaket som innehåller lokaliserade resurser för specifika kulturer. Språkpaketen är tillgängliga från nedladdningssidorna för .NET Framework:

• .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

Från och med .NET Framework 4.5.1 har paketnamnen formatet NDP-KB-x86-x64-AllOS<>>number<version->culture<.exe, där version är versionsnumret för .NET Framework, number är ett Microsoft Knowledge Base-artikelnummer och culture anger ett land/en region. Ett exempel på ett av dessa paket är NDP452-KB2901907-x86-x64-AllOS-JPN.exe. Paketnamn visas i avsnittet Omdistribuerbara paket tidigare i den här artikeln.

Om du vill installera ett språkpaket med offlineinstallationsprogrammet för .NET Framework måste du länka det till appens konfiguration. Om du till exempel vill distribuera .NET Framework 4.5.1 offlineinstallationsprogram med det japanska språkpaketet använder du följande kommando:

NDP451-KB2858728-x86-x64-AllOS-JPN.exe /q /norestart /ChainingPackage <ProductName>

Du behöver inte länka språkpaketen om du använder webbinstallationsprogrammet. installationsprogrammet installerar språkpaketet som matchar användarens MUI-inställning. Om du vill installera ett annat språk kan du använda /LCID alternativet för att ange ett språkpaket.

En fullständig lista över kommandoradsalternativ finns i avsnittet Kommandoradsalternativ .

Felsökning

Returkoder

I följande tabell visas de vanligaste returkoderna för installationsprogrammet för omdistribuerbart .NET Framework. Returkoderna är desamma för alla versioner av installationsprogrammet. Länkar till detaljerad information finns i nästa avsnitt.

Ladda ned felkoder

Se följande innehåll:

• Felkoder för Background Intelligent Transfer Service (BITS)

• URL-monikerfelkoder

• WinHttp-felkoder

Andra felkoder

Se följande innehåll:

• Felkoder för Windows Installer

• Resultatkoder för Windows Update Agent

Avinstallera .NET Framework

Från och med Windows 8 kan du avinstallera .NET Framework 4.5 eller senare versioner med hjälp av Aktivera och inaktivera Windows-funktioner i Kontrolna tabla. I äldre versioner av Windows kan du avinstallera .NET Framework 4.5 eller senare versioner med hjälp av Lägg till eller ta bort program i Kontrolna tabla.

Bilaga

Alternativ för kommandoraden

I följande tabell visas alternativ som du kan inkludera när du kedjar om .NET Framework 4.5 som kan omdistribueras till appens konfiguration.

Språk som stöds

I följande tabell visas .NET Framework-språkpaket som är tillgängliga för .NET Framework 4.5 och senare versioner.

Se även

• Distributionsguide för administratörer
• Systemkrav
• Installera .NET Framework för utvecklare
• Felsöka blockerade .NET Framework-installationer och avinstallationer
• Minska systemomstarter under .NET Framework 4.5-installationer
• Anvisningar: Hämta förlopp från installationsprogrammet för .NET Framework 4.5