Teilen über


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

Hinweis

Dieser Artikel gilt für das .NET Framework. Er gilt nicht für neuere Implementierungen von .NET, einschließlich .NET 6 und höherer Versionen.

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:

Wichtig

.NET Framework Inhalte, die zuvor digital mithilfe von Zertifikaten unter Verwendung des SHA-1-Algorithmus signiert wurden, werden zur Unterstützung sich weiterentwickelnder Branchenstandards als veraltet markiert.

Die folgenden Versionen von .NET Framework erreichen das Ende des Supports am 26. April 2022: 4.5.2, 4.6 und 4.6.1. Nach diesem Datum werden keine Sicherheitsfixes und Updates und kein technischer Support für diese Versionen mehr bereitgestellt.

Wenn Sie .NET Framework 4.5.2, 4.6 oder 4.6.1 verwenden, aktualisieren Sie Ihre bereitgestellte Runtime vor dem 26. April 2022 auf eine neuere Version (z. B. .NET Framework 4.6.2), um weiterhin Updates und technischen Support zu erhalten.

Aktualisierte mit SHA-2 signierte Installationsprogramme sind für .NET Framework 3.5 SP1 und 4.6.2 bis 4.8 verfügbar. Weitere Informationen finden Sie im Plan zur Einstellung von SHA-1, im Blogbeitrag zur Aktualisierung des Lebenszyklus von .NET 4.5.2, 4.6 und 4.6.1 und in den häufig gestellten Fragen.

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.

Bereitstellungsstrategie für die App Verfügbare Bereitstellungsmethoden Zu verwendendes verteilbares .NET Framework-Paket
Installation aus dem Web - InstallAware
- InstallShield
- WiX-Toolset
- Manuelle Installation
Web installer
Installation von Datenträger - InstallAware
- InstallShield
- WiX-Toolset
- Manuelle Installation
Offline installer
Installation von einem lokalen Netzwerk (für Unternehmens-Apps) - ClickOnce Entweder Webinstaller (siehe ClickOnce für Einschränkungen) oder Offlineinstaller

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:

Webinstaller Offlineinstaller
Internetverbindung erforderlich? Ja Nein
Größe des Downloads Kleiner (enthält nur Installationsprogramm für die Zielplattform)* Größer*
Language Packs Enthalten** Muss getrennt installiert werden, außer Sie verwenden das Paket, das auf alle Betriebssysteme abzielt
Bereitstellungsmethode Unterstützt alle Methoden:

- ClickOnce
- InstallAware
- InstallShield
- Windows Installer XML (WiX)
- Manuelle Installation
- Benutzerdefiniertes Setup (Verkettung)
Unterstützt alle Methoden:

- ClickOnce
- InstallAware
- InstallShield
- Windows Installer XML (WiX)
- Manuelle Installation
- Benutzerdefiniertes Setup (Verkettung)

* 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:

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.

Wichtig

Wenn Sie ermitteln möchten, ob eine bestimmte Version vorliegt, prüfen Sie auf einen Wert, der größer als oder gleich dem Wert des Releaseschlüsselworts ist.

Version Wert des Versions-DWORD
.NET Framework 4.8.1 533325
.NET Framework 4.8, installiert unter dem Windows 10-Update von Mai 2020 und dem Windows 10-Update vom Oktober 2020 528372
.NET Framework 4.8, installiert unter dem Windows 10-Update von Mai 2019 und dem Windows 10-Update vom November 2019 528040
.NET Framework 4.8, installiert in allen Betriebssystemversionen außer den aufgeführten Windows 10-Updateversionen 528049
.NET Framework 4.7.2, installiert im Windows 10-Update von April 2018 und in Windows Server Version 1803 461808
.NET Framework 4.7.2, installiert in allen Betriebssystemversionen, abgesehen vom Windows 10-Update von April 2018 und Windows Server Version 1803. Dies umfasst das Windows 10-Update von Oktober 2018. 461814
.NET Framework 4.7.1, installiert im Windows 10 Fall Creators Update und Windows Server Version 1709 461308
.NET Framework 4.7.1, installiert in allen Betriebssystemversionen, abgesehen vom Windows 10 Fall Creators Update und Windows Server Version 1709 461310
.NET Framework 4.7 installiert unter Windows 10 Creators Update 460798
.NET Framework 4.7 wird unter allen Betriebssystemen außer Windows 10 Creators Update installiert 460805
.NET Framework 4.6.2, installiert in der Windows 10 Anniversary Edition und unter Windows Server 2016 394802
.NET Framework 4.6.2, installiert in allen Betriebssystemversionen außer Windows 10 Anniversary Edition und Windows Server 2016 394806
.NET Framework 4.6.1, installiert im November-Update von Windows 10 394254
.NET Framework 4.6.1, installiert in allen Betriebssystemversionen außer dem November-Update von Windows 10 394271
.NET Framework 4.6, installiert unter Windows 10 393295
.NET Framework 4.6, installiert in allen Betriebssystemversionen außer Windows 10 393297
.NET Framework 4.5.2 379893
.NET Framework 4.5.1 installiert mit Windows 8.1 oder Windows Server 2012 R2 378675
.NET Framework 4.5.1, installiert unter Windows 8, Windows 7 378758
.NET Framework 4.5 378389

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:

Wert
Schlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\1041
Eingabe Freigabe
Typ DWORD

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:

Wichtig

Die Sprachpakete enthalten nicht die .NET Framework-Komponenten, die zum Ausführen einer App erforderlich sind. Sie müssen .NET Framework mithilfe des Web- oder Offlineinstallationsprogramms installieren, bevor Sie ein Sprachpaket installieren.

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.

Rückgabecode Beschreibung
0 Die Installation wurde erfolgreich abgeschlossen.
1602 Der Benutzer hat die Installation abgebrochen.
1603 Während der Installation ist ein schwerwiegender Fehler aufgetreten.
1641 Ein Neustart ist erforderlich, um die Installation abzuschließen. Diese Meldung zeigt eine erfolgreiche Installation an.
3010 Ein Neustart ist erforderlich, um die Installation abzuschließen. Diese Meldung zeigt eine erfolgreiche Installation an.
5100 Der Computer des Benutzers erfüllt die Systemanforderungen nicht.

Downloadfehlercodes

Fügen Sie den folgenden Inhalt hinzu:

Sonstige Fehlercodes

Fügen Sie den folgenden Inhalt hinzu:

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.

Wichtig

Unter Windows 7 und früheren Betriebssystemen werden bei der Deinstallation von .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 oder 4.8.1 .NET Framework 4.5-Dateien nicht wiederhergestellt, und bei der Deinstallation von .NET Framework 4.5 werden .NET Framework 4-Dateien nicht wiederhergestellt. Wenn Sie wieder die ältere Version verwenden möchten, müssen Sie diese Version und alle Updates für sie neu installieren.

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.

Option Beschreibung
/CEIPConsent Überschreibt das Standardverhalten und sendet anonymes Feedback an Microsoft, um die Bereitstellungsumgebung für die Zukunft zu verbessern. Diese Option kann nur verwendet werden, wenn vom Setupprogramm die Zustimmung angefordert wird und der Benutzer die Berechtigung erteilt, anonymes Feedback an Microsoft zu senden.
/chainingpackage packageName Gibt den Namen der ausführbaren Datei an, die das Verketten ausführt. Diese Informationen werden als anonymes Feedback an Microsoft gesendet, um zu helfen, die Bereitstellungsumgebung für die Zukunft zu verbessern.

Wenn der Paketname Leerzeichen enthält, verwenden Sie als Trennzeichen doppelte Anführungszeichen, z.B. /chainingpackage "Lucerne Publishing" . Ein Beispiel für ein Verkettungspaket finden Sie unter Abrufen von Statusinformationen aus einem Installationspaket.
/LCID LCID

wobei LCID einen Gebietsschemabezeichner angibt (siehe Unterstützte Sprachen)
Installiert das von LCID angegebene Language Pack und erzwingt die Anzeige der Benutzeroberfläche in dieser Sprache (sofern nicht der stille Modus festgelegt wird).

Bei Verwendung des Webinstallers wird mit dieser Option das Language Pack per Verkettung aus dem Web installiert. Hinweis: Verwenden Sie diese Option nur mit dem Webinstaller.
/log file | folder Gibt den Speicherort der Protokolldatei an. Der Standardwert ist der temporäre Ordner für den Vorgang, und der Standarddateiname basiert auf dem Paket. Wenn die Dateierweiterung TXT lautet, wird ein Textprotokoll präsentiert. Wenn Sie eine andere Erweiterung oder keine Erweiterung angeben, wird ein HTML-Protokoll erstellt.
/msioptions Gibt Optionen an, die für MSI- und MSP-Elemente übergeben werden sollen. Beispiel: /msioptions "PROPERTY1='Value'".
/norestart Verhindert, dass das Setupprogramm automatisch erneut gestartet wird. Wenn Sie diese Option verwenden, muss die verkettende App den Rückgabecode erfassen und den Neustart initiieren (siehe Abrufen von Statusinformationen aus einem Installationspaket).
/passive Legt den passiven Modus fest. Zeigt die Statusleiste an, um anzugeben, dass die Installation ausgeführt wird, zeigt dem Benutzer jedoch keine Eingabeaufforderungen oder Fehlermeldungen an. In diesem Modus muss, sofern er durch ein Setupprogramm verkettet ist, das Verkettungspaket Rückgabecodesbehandeln.
/pipe Erstellt einen Kommunikationskanal, damit ein Verkettungspaket bearbeitet werden kann.
/promptrestart Wenn im passiven Modus das Setupprogramm einen Neustart erfordert, wird der Benutzer zur Eingabe aufgefordert. Bei dieser Option muss der Benutzer eingreifen, wenn ein Neustart erforderlich ist.
/q Legt den stillen Modus fest.
/repair Löst die Reparaturfunktionalität aus.
/serialdownload Erzwingt, dass die Installation erst erfolgt, nachdem das Paket heruntergeladen wurde.
/showfinalerror Legt den passiven Modus fest. Zeigt Fehler nur an, wenn die Installation nicht erfolgreich ist. Bei dieser Option muss der Benutzer eingreifen, wenn die Installation nicht erfolgreich ist.
/showrmui Wird ausschließlich mit der Option /passive verwendet. Zeigt ein Meldungsfeld an, das Benutzer auffordert, derzeit ausgeführte .NET Framework-Apps zu schließen. Dieses Meldungsfeld verhält sich im passiven und im nicht passiven Modus gleich.
/uninstall Deinstalliert das verteilbare .NET Framework-Paket.

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.

LCID Sprache – Land/Region culture
1025 Arabisch - Saudi-Arabien ar
1028 Chinesisch (traditionell) zh-Hant
1029 Tschechisch cs
1030 Dänisch da
1031 Deutsch (Deutschland) de
1032 Griechisch el
1035 Finnisch fi
1036 Französisch (Frankreich) fr
1037 Hebräisch er
1038 Ungarisch hu
1040 Italienisch (Italien) it
1041 Japanisch ja
1042 Koreanisch ko
1043 Niederländisch (Niederlande) nl
1044 Norwegisch (Bokmål) Nein
1045 Polnisch pl
1046 Portugiesisch (Brasilien) pt-BR
1049 Russisch ru
1053 Schwedisch sv
1.055 Türkisch tr
2052 Chinesisch (vereinfacht) zh-Hans
2070 Portugiesisch (Portugal) pt-PT
3082 Spanisch – Spanien (Moderne Sortierreihenfolge) es

Siehe auch