Handbuch für die Bereitstellung von .NET Framework für Entwickler

Dieser Artikel enthält Informationen für Entwickler*innen, die eine beliebige .NET Framework-Version – von .NET Framework 4.5 bis .NET Framework 4.8 – mit ihren Apps installieren möchten.

Sie können die weitervertreibbaren Pakete und Language Packs für .NET Framework von den Downloadseiten herunterladen:

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

Wichtige Hinweise:

• Die .NET Framework-Versionen von .NET Framework 4.5.1 bis .NET Framework 4.8 sind direkte Updates für .NET Framework 4.5. Dies bedeutet, dass sie dieselbe Runtimeversion, aber jeweils aktualisierte Assemblyversionen mit neuen Typen und Membern verwenden.

• .NET Framework 4.5 und höhere Versionen bauen inkrementell auf .NET Framework 4 auf. Wenn Sie .NET Framework 4.5 oder höhere Versionen auf einem System installieren, auf dem .NET Framework 4 installiert ist, werden die Assemblys der Version 4 durch neuere Versionen ersetzt.

• Wenn Sie in Ihrer App auf ein Microsoft Out-of-Band-Paket verweisen, wird die Assembly in das App-Paket aufgenommen.

• Sie müssen über Administratorrechte verfügen, um .NET Framework 4.5 oder höhere Versionen zu installieren.

• .NET Framework 4.5 ist Windows 8 und Windows Server 2012 enthalten. Daher müssen Sie diese Komponente für diese Betriebssysteme nicht mit Ihrer App bereitstellen. Ebenso ist .NET Framework 4.5.1 in Windows 8.1 und Windows Server 2012 R2 enthalten. .NET Framework 4.5.2 ist in keinem Betriebssystem enthalten. .NET Framework 4.6 ist in Windows 10 enthalten, .NET Framework 4.6.1 ist im November-Update von Windows 10 enthalten, und .NET Framework 4.6.2 ist im Windows 10 Anniversary Update enthalten. .NET Framework 4.7 ist im Windows 10 Creators Update enthalten, .NET Framework 4.7.1 ist im Windows 10 Fall Creators Update enthalten, und .NET Framework 4.7.2 ist in den Windows 10-Updates von April 2018 und Oktober 2018 enthalten. .NET Framework 4.8 ist im Windows 10-Update vom Mai 2019 enthalten sowie in allen anschließenden Windows 10-Updates. Eine vollständige Liste der Hardware- und Softwareanforderungen finden Sie unter Systemanforderungen für .NET Framework.

• Ab .NET Framework 4.5. können die Benutzer während des Setups eine Liste der aktiven .NET Framework-Apps anzeigen und diese Apps einfach schließen. Dies hilft möglicherweise, durch .NET Framework-Installationen verursachte Systemneustarts zu vermeiden. Informationen hierzu finden Sie unter Reduzieren von Systemneustarts.

• Durch Deinstallieren von .NET Framework 4.5 oder höheren Versionen werden auch bereits vorhandene .NET Framework 4-Dateien entfernt. Wenn Sie zu .NET Framework 4 zurückkehren möchten, müssen Sie diese Version und alle Updates für sie neu installieren. Weitere Informationen finden Sie in Installieren von .NET Framework 4.

• Die Redistributable-Version von .NET Framework 4.5 wurde am 9. Oktober 2012 aktualisiert, um ein Problem im Zusammenhang mit einem falschen Zeitstempel in einem digitalen Zertifikat zu beheben. Dies verursachte den vorzeitigen Ablauf der digitalen Signatur auf von Microsoft erstellten und signierten Dateien. Wenn Sie zuvor das weitervertreibbare .NET Framework 4.5-Paket vom 16. August 2012 installiert hatten, wird empfohlen, die Kopie anhand des neuesten weitervertreibbaren Pakets von der .NET Framework-Downloadseite zu aktualisieren. Weitere Informationen zu diesem Problem finden Sie in der Microsoft-Sicherheitsempfehlung (2749655).

Informationen zum Bereitstellen von .NET Framework und den Systemabhängigkeiten in einem Netzwerk durch einen Systemadministrator finden Sie im Deployment Guide for Administrators (Handbuch für die Bereitstellung für Administratoren).

Bereitstellungsoptionen für die App

Wenn Sie die App auf einem Webserver oder an einem anderen zentralen Speicherort veröffentlichen, damit sie von Benutzern installiert werden kann, können Sie aus mehreren Bereitstellungsmethoden auswählen. Einige davon werden mit Visual Studio bereitgestellt. In der folgenden Tabelle werden die Bereitstellungsoptionen für Ihre App aufgeführt, und es wird das verteilbare .NET Framework-Paket angegeben, das die jeweilige Option unterstützt. Außerdem können Sie ein benutzerdefiniertes Setupprogramm für die App schreiben. Weitere Informationen finden Sie im Abschnitt Verketten der .NET Framework-Installation mit dem Setup der App.

Weitervertreibbare Pakete

.NET Framework ist in zwei verteilbaren Paketen verfügbar: Webinstaller (Bootstrapper) und Offlineinstaller (eigenständiges verteilbares Paket). Alle .NET Framework-Downloads werden auf der .NET Framework-Downloadseite gehostet. In der folgenden Tabelle werden die beiden Pakete verglichen:

* Der Offlineinstaller ist das größere Paket, da es Komponenten für alle Zielplattformen enthält. Nach Abschluss des Setups speichert das Windows-Betriebssystem nur das Installationsprogramm, das verwendet wurde. Wenn der Offlineinstaller nach der Installation gelöscht wird, ist die Menge an verwendetem Speicherplatz identisch zum Webinstaller. Wenn das von Ihnen verwendete Tool zum Erstellen des Setupprogramms Ihrer App (beispielsweise InstallAware oder InstallShield) einen Setupdateiordner verwendet, der nach der Installation entfernt wird, können Sie den Offlineinstaller im Setupordner ablegen, damit er automatisch gelöscht wird.

** Wenn Sie den Webinstaller mit benutzerdefiniertem Setup verwenden, können Sie die Standardspracheinstellungen auf Grundlage der MUI (Multilingual User Interface)-Einstellung des Benutzers verwenden oder in der Befehlszeile mit der /LCID -Option ein anderes Language Pack angeben. Entsprechende Beispiele finden Sie im Abschnitt Verketten mithilfe der .NET Framework-Standardbenutzeroberfläche .

Bereitstellungsmethoden

Es sind vier Bereitstellungsmethoden verfügbar:

• Sie können eine Abhängigkeit von .NET Framework festlegen. Sie können mit einer der folgenden Methoden .NET Framework als erforderliche Komponente in der Installation der App angeben:

  • Verwenden der ClickOnce-Bereitstellung (in Visual Studio verfügbar)

  • Erstellen eines InstallAware-Projekts (kostenlose Edition für Visual Studio-Benutzer verfügbar)

  • Erstellen eines InstallShield-Projekts (in Visual Studio verfügbar)

  • Verwenden des WiX (Windows Installer XML)-Toolsets

• Sie können die Benutzer bitten, .NET Framework manuell zu installieren.

• Sie können das Setup von .NET Framework mit dem Setup der App verketten (in das Setup einschließen) und festlegen, wie der .NET Framework-Installationsvorgang erfolgen soll:

  • Verwenden der Standardbenutzeroberfläche Ausführen der Installation durch das .NET Framework-Installationsprogramm

  • Anpassen der Benutzeroberfläche , um einen einheitlichen Installationsvorgang bereitzustellen und den .NET Framework-Installationsstatus zu überwachen

Diese Bereitstellungsmethoden werden in den folgenden Abschnitten ausführlich erläutert.

Festlegen einer Abhängigkeit von .NET Framework

Wenn Sie die App mit ClickOnce, InstallAware, InstallShield oder WiX bereitstellen, können Sie eine Abhängigkeit vom .NET Framework hinzufügen, sodass das .NET Framework als Teil der App installiert werden kann.

ClickOnce-Bereitstellung

ClickOnce-Bereitstellung ist für Projekte verfügbar, die mit Visual Basic und Visual C# wurden, ist für Visual C++ jedoch nicht verfügbar.

So wählen Sie in Visual Studio die ClickOnce-Bereitstellung aus und fügen eine Abhängigkeit von .NET Framework hinzu:

1. Öffnen Sie das App-Projekt, das Sie veröffentlichen möchten.

2. Öffnen Sie im Projektmappen-Explorer das Kontextmenü für das Projekt, und wählen Sie Eigenschaftenaus.

3. Wählen Sie den Bereich Veröffentlichen aus.

4. Klicken Sie auf die Schaltfläche Erforderliche Komponenten .

5. Stellen Sie im Dialogfeld Erforderliche Komponenten sicher, dass das Kontrollkästchen Setupprogramm zur Installation erforderlicher Komponenten erstellen aktiviert ist.

6. Suchen Sie in der Liste der erforderlichen Komponenten nach der Version von .NET Framework, mit der Sie Ihr Projekt erstellt haben, und wählen Sie diese Version aus.

7. Wählen Sie eine Option aus, um den Quellspeicherort für die erforderlichen Komponenten anzugeben, und klicken Sie dann auf OK.

   Wenn Sie als Downloadspeicherort für .NET Framework eine URL bereitstellen, können Sie entweder die .NET Framework-Downloadseite oder eine eigene Website angeben. Wenn Sie das verteilbare Paket auf einem eigenen Server ablegen, müssen Sie den Offlineinstaller verwenden, nicht den Webinstaller. Sie können lediglich einen Link zum Webinstaller auf der .NET Framework-Downloadseite verwenden. Die URL kann auch auf einen Datenträger verweisen, auf dem eine eigene App verteilt wird.

8. Klicken Sie im Dialogfeld Eigenschaftenseiten auf OK.

InstallAware-Bereitstellung

InstallAware erstellt über eine einzige Quelle die Windows-App (APPX), den Windows Installer (MSI), den nativen Code (EXE) und App-V-Pakete (Application Virtualization). Sie können mühelos eine beliebige .NET Framework-Version in Ihr Setup einschließen und optional die Installation durch Bearbeiten der Standardskripts anpassen. Beispielsweise installiert InstallAware Zertifikate unter Windows 7, ohne die beim Setup für .NET Framework 4.7 ein Fehler auftritt. Weitere Informationen zu InstallAware finden Sie auf der Website von InstallAware für den Windows Installer.

InstallShield-Bereitstellung

Mit InstallShield werden Windows-App-Pakete (MSIX und APPX), Windows Installer-Pakete (MSI) sowie Installationsprogramme für nativen Code (EXE) erstellt. InstallShield bietet ebenso die Visual Studio-Integration. Weitere Informationen finden Sie auf der InstallShield-Website.

WiX (Windows Installer XML)-Bereitstellung

Mit dem WiX (Windows Installer XML)-Toolset werden Windows-Installationspakete aus XML-Quellcode erstellt. WiX unterstützt eine Befehlszeilenumgebung, die in die Buildprozesse integriert werden kann, um MSI- und MSM-Setuppakete zu erstellen. Mit WiX können Sie .NET Framework als erforderliche Komponente angeben, oder Sie können einen Chainer erstellen , um die Bereitstellung von .NET Framework vollständig zu steuern. Weitere Informationen zu WiX finden Sie auf der Website für das WiX (Windows Installer XML)-Toolset .

Manuelles Installieren von .NET Framework-Versionen

In manchen Situationen kann die automatische Installation von .NET Framework mit Ihrer Anwendung möglicherweise nicht ausgeführt werden. In diesem Fall können Sie .NET Framework von den Benutzern selbst installieren lassen. Das verteilbare Paket ist in zwei Paketenverfügbar. Im Setupprozess stellen Sie Anweisungen dafür bereit, wie Benutzer zur Suche und Installation von .NET Framework vorgehen müssen.

Verketten der .NET Framework-Installation mit dem Setup der App

Wenn Sie ein benutzerdefiniertes Setupprogramm für die App erstellen, können Sie den .NET Framework-Setupvorgang mit dem Setupvorgang der App verketten (in das Setup einschließen). Durch das Verketten werden zwei Benutzeroberflächenoptionen für die .NET Framework-Installation bereitgestellt:

• Verwenden der vom .NET Framework-Installationsprogramm bereitgestellten Standardbenutzeroberfläche

• Erstellen einer benutzerdefinierten Benutzeroberfläche für die .NET Framework-Installation, die mit dem Setupprogramm der App konsistent ist

Beide Methoden ermöglichen es Ihnen, entweder den Webinstaller oder den Offlineinstaller zu verwenden. Jedes Paket bietet eigene Vorteile:

• Beim Verwenden des Webinstallers erkennt das .NET Framework-Setup, welches Installationspaket erforderlich ist, und lädt nur dieses Paket herunter und installiert es.

• Beim Verwenden des Offlineinstallers können Sie den vollständigen Satz von .NET Framework-Installationspaketen in die Verteilungsmedien einschließen, damit die Benutzer während des Setups keine zusätzlichen Dateien aus dem Web herunterladen müssen.

Verketten mithilfe der .NET Framework-Standardbenutzeroberfläche

Zum automatischen Verketten des .NET Framework-Installationsvorgangs und Bereitstellen der Benutzeroberfläche durch das .NET Framework-Installationsprogramm fügen Sie dem Setupprogramm den folgenden Befehl hinzu:

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

Wenn beispielsweise das Programm „Contoso.exe“ lautet und Sie das weitervertreibbare .NET Framework 4.5-Offlinepaket unbeaufsichtigt installieren lassen möchten, verwenden Sie folgenden Befehl:

dotNetFx45_Full_x86_x64.exe /q /norestart /ChainingPackage Contoso

Sie können die Installation mit zusätzlichen Befehlszeilenoptionen anpassen. Zum Beispiel:

• Um Benutzern das Schließen aktiver .NET Framework-Apps zu ermöglichen und Systemneustarts zu minimieren, legen Sie den passiven Modus fest, und verwenden Sie die Option /showrmui wie folgt:

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

  Dieser Befehl ermöglicht dem Neustart-Manager das Anzeigen eines Meldungsfelds, das Benutzern die Möglichkeit bietet, .NET Framework-Apps zu schließen, bevor das .NET Framework installiert wird.

• Wenn Sie den Webinstaller verwenden, können Sie mit der Option /LCID ein Language Pack angeben. Um beispielsweise den .NET Framework 4.5-Webinstaller mit dem Contoso-Setupprogramm zu verketten und das Language Pack für Japanisch zu installieren, fügen Sie dem Setupvorgang der App den folgenden Befehl hinzu:

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

  Wenn Sie die Option /LCID weglassen, wird das Language Pack installiert, das der Benutzereinstellung für die MUI entspricht.

  Hinweis

  Unterschiedliche Language Packs können verschiedene Versionsdatumsangaben aufweisen. Wenn das angegebene Language Pack im Download Center nicht verfügbar ist, wird .NET Framework ohne das Language Pack installiert. Wenn .NET Framework auf dem Computer des Benutzers bereits installiert ist, wird nur das Language Pack installiert.

Eine vollständige Liste der Optionen finden Sie im Abschnitt Befehlszeilenoptionen .

Häufige Rückgabecodes finden Sie im Abschnitt Rückgabecodes .

Verketten mithilfe einer benutzerdefinierten Benutzeroberfläche

Wenn Sie ein benutzerdefiniertes Setuppaket verwenden, können Sie das .NET Framework-Setup automatisch starten und eine eigene Ansicht des Setupstatus anzeigen lassen. Stellen Sie in diesem Fall sicher, dass der Code folgenden Anforderungen entspricht:

• Überprüfung auf Hardware- und Softwareanforderungen für .NET Framework.

• Erkennen , ob bereits die richtige Version von .NET Framework auf dem Computer des Benutzers installiert ist.

  Wichtig

  Bei der Bestimmung, ob die richtige Version von .NET Framework bereits installiert ist, sollten Sie überprüfen, ob Ihre Zielversion oder eine höhere Version installiert ist und nicht nur, ob Ihre Zielversion installiert ist. Sie sollen also bewerten, ob der Release-Schlüssel, den Sie aus der Registrierung enthalten, größer oder gleich dem Release-Schlüssel Ihrer Zielversion ist und nicht , ob er gleich dem Release-Schlüssel Ihrer Zielversion ist.

• Erkennen , ob die Language Packs bereits auf dem Computer des Benutzers installiert sind.

• Wenn Sie die Bereitstellung steuern möchten, lassen Sie den .NET Framework-Setupvorgang automatisch starten und nachverfolgen (weitere Informationen finden Sie unter Vorgehensweise: Abrufen des Status vom Installationsprogramm für .NET Framework 4.5).

• Wenn Sie den Offlineinstaller bereitstellen, verketten Sie die Language Packs separat.

• Passen Sie die Bereitstellung mit Befehlszeilenoptionenan. Wenn Sie beispielsweise den .NET Framework-Webinstaller verketten, jedoch das standardmäßige Language Pack überschreiben möchten, verwenden Sie die /LCID -Option, wie im vorherigen Abschnitt beschrieben.

• Problembehandlung.

Erkennen von .NET Framework

Das .NET Framework-Installationsprogramm schreibt Registrierungsschlüssel, wenn die Installation erfolgreich verläuft. Sie können testen, ob .NET Framework 4.5 oder höher installiert ist, indem Sie den Ordner HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full in der Registrierung auf einen DWORD-Wert namens Release überprüfen. (Beachten Sie, dass „.NET Framework Setup“ nicht mit einem Punkt beginnt.) Wenn dieser Schlüssel vorhanden ist, bedeutet dies, dass .NET Framework 4.5 oder eine höhere Version auf diesem Computer installiert wurde. Der Wert von Release gibt an, welche Version von .NET Framework installiert ist.

Erkennen von Sprachpaketen

Sie können testen, ob ein bestimmtes Sprachpaket installiert ist, indem Sie in der Registrierung überprüfen, ob der Ordner „HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\LCID“ den DWORD-Wert namens Release enthält. (Beachten Sie, dass „.NET Framework Setup“ nicht mit einem Punkt beginnt.) LCID gibt einen Gebietsschemabezeichner an. Eine Liste dieser Bezeichner finden Sie unter Unterstützte Sprachen.

Rufen Sie beispielsweise aus der Registrierung den folgenden benannten Wert ab, um zu ermitteln, ob das gesamte japanische Sprachpaket (LCID=1041) installiert wurde:

Um festzustellen, ob die endgültige Version eines Sprachpakets für eine bestimmte .NET Framework-Version (4.5 bis 4.7.2) installiert ist, überprüfen Sie den DWORD-Wert des RELEASE-Schlüssels, der im vorherigen Abschnitt Erkennen von .NET Framework beschrieben wurde.

Verketten der Sprachpakete mit dem App-Setup

.NET Framework stellt einen Satz eigenständiger ausführbarer Sprachpaketdateien bereit, die lokalisierte Ressourcen für bestimmte Kulturen enthalten. Die Sprachpakete sind auf den .NET Framework-Downloadseiten verfügbar:

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

Ab .NET Framework 4.5.1 weisen die Paketnamen folgendes Format auf: NDP<version>-KB<number>-x86-x64-AllOS-<culture>.exe. Dabei steht version für die Versionsnummer von .NET Framework, number für die Nummer eines Artikels in der Microsoft Knowledge Base und culture für ein Land/eine Region. Ein Beispiel für einen solchen Paketnamen ist NDP452-KB2901907-x86-x64-AllOS-JPN.exe. Paketnamen sind im Abschnitt Redistributable Packages dieses Artikels aufgelistet.

Um ein Sprachpaket mit dem .NET Framework-Offlineinstaller zu installieren, müssen Sie es mit dem Setup der App verketten. Verwenden Sie beispielsweise zum Bereitstellen des .NET Framework 4.5.1-Offlineinstallers mit dem Language Pack für Japanisch den folgenden Befehl:

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

Sie müssen die Language Packs nicht verketten, wenn Sie den Webinstaller verwenden. In diesem Fall installiert Setup das Language Pack, das der MUI-Einstellung des Benutzers entspricht. Wenn Sie eine andere Sprache installieren möchten, können Sie mit der Option /LCID ein Language Pack angeben.

Eine vollständige Liste der Befehlszeilenoptionen finden Sie im Abschnitt Befehlszeilenoptionen .

Problembehandlung

Rückgabecodes

In der folgenden Tabelle sind die häufigsten Rückgabecodes für das verteilbare Installationsprogramm für .NET Framework aufgeführt. Die Rückgabecodes sind für alle Versionen des Installationsprogramms identisch. Links zu ausführlichen Informationen finden Sie im nächsten Abschnitt.

Downloadfehlercodes

Fügen Sie den folgenden Inhalt hinzu:

• Fehlercodes für BITS (Background Intelligent Transfer Service)

• Fehlercodes für URL-Moniker

• Fehlercodes für WinHttp

Sonstige Fehlercodes

Fügen Sie den folgenden Inhalt hinzu:

• Fehlercodes für Windows Installer

• Ergebniscodes für Windows Update Agent

Deinstallieren von .NET Framework

Ab Windows 8 können Sie .NET Framework 4.5 oder höhere Versionen über die Option Windows-Funktionen aktivieren oder deaktivieren in der Systemsteuerung deinstallieren. In früheren Versionen von Windows können Sie .NET Framework 4.5 oder höhere Versionen über die Option Programme hinzufügen oder entfernen in der Systemsteuerung deinstallieren.

Anhang

Befehlszeilenoptionen

In der folgenden Tabelle sind die Optionen aufgeführt, die Sie einschließen können, wenn Sie das weitervertreibbare .NET Framework 4.5-Paket mit dem Setup Ihrer App verketten.

Unterstützte Sprachen

In der folgenden Tabelle sind die .NET Framework-Language Packs aufgeführt, die für .NET Framework 4.5 und höhere Versionen verfügbar sind.

Siehe auch

• Bereitstellungshandbuch für Administratoren
• Systemanforderungen
• Installieren von .NET Framework für Entwickler
• Problembehandlung bei blockierten Installationen und Deinstallationen von .NET Framework
• Reduzieren von Systemneustarts bei .NET Framework 4.5-Installationen
• How to: Abrufen des Status vom Installationsprogramm für .NET Framework 4.5