Microsoft .NET Framework 3.0-Bereitstellungshandbuch

Artikel
05/11/2010
9 Minuten Lesedauer

Microsoft Corporation

Juli 2006

Inhalte

Zusammenfassung
Einführung
Installationsanforderungen
   Softwareanforderungen
   Hardwareanforderungen
Wo die .NET Framework 3.0 Redistributable Package abgerufen werden soll
.NET Framework 3.0 mit einem Visual Studio 2005 Setup Project
Benutzer installieren die .NET Framework manuell
Verketten des Redistributable-Pakets in Ihrem Anwendungseinrichtung
Weiterverteiler .NET Framework 3.0 für Webanwendungen
Erkennen von Microsoft .NET Framework 3.0
   Lesen von Registrierungsschlüsseln
   Lesen der Benutzer-Agent-Zeichenfolge in Internet Explorer
Befehlszeilenoptionen für die .NET Framework 3.0 Redistributable
Fehlercodes für die .NET Framework 3.0 Redistributable

Zusammenfassung

In diesem Artikel wird beschrieben, wie Sie Microsoft .NET Framework 3.0-Anwendungen mit Dotnetfx3.exe bereitstellen, das .NET Framework 3.0-Redistributable-Paket. (10 gedruckte Seiten)

Hinweis Diese Dokumentation kann Informationen für Szenarien enthalten, die die Verteilung diskutieren, aber die Dokumentation gewährt Ihnen keine Rechte zum Verwenden oder Verteilen eines Teils der Komponenten. Ihre Nutzung der Komponenten unterliegt dem Lizenzvertrag für die Komponenten. Überprüfen Sie die Lizenzvereinbarung für Komponenten, um Ihre Rechte und die Nutzungsbedingungen zu verstehen.

Einführung

Das Microsoft.NET Framework 3.0 stellt ein verteilbares Installationsprogramm bereit, das .NET Framework 2.0-Bindungen an die erforderlichen Windows Vista-APIs enthält, um .NET Framework 3.0-Anwendungen auszuführen.

Das .NET Framework 3.0-Paket ist als eigenständige ausführbare Datei verfügbar. Der Name der Datei hängt vom Typ der gezielten Plattform ab. Für 32-Bit-Plattformen wird die Datei Dotnetfx3.exe benannt. Für 64-Bit-Plattformen wird die Datei Dotnetfx3_x64.exe benannt. Sie können auch ein kleines redistributable-Paket namens Dotnet3setup.exe bereitstellen, das die erforderlichen Komponenten während des Setups herunterlädt.

Hinweis IA64-Support in .NET Framework 3.0 ist auf Microsoft Windows Server-Code mit dem Namen "Longhorn" beschränkt. Longhorn umfasst bereits .NET Framework 3.0, daher ist kein verteilbares Paket erforderlich.

Sie können die Redistributable manuell auf einem Computer starten und installieren, oder sie kann als Teil des Setupprogramms für eine .NET Framework 3.0-Anwendung gestartet und installiert werden.

Hinweis Administratorrechte sind erforderlich, um die .NET Framework 3.0 zu installieren.

Installationsanforderungen

In diesem Abschnitt werden die Software- und Hardwareanforderungen für einen Computer beschrieben, auf dem das Microsoft-.NET Framework 3.0-Paket installiert werden soll. Wenn die Mindestanforderungen nicht erfüllt sind, blockiert Dotnetfx3.exe die Installation des verteilbaren Pakets.

Softwareanforderungen

Um Microsoft .NET Framework 3.0 zu installieren, muss eine der folgenden Betriebssysteme auf dem Zielcomputer installiert werden:

Microsoft Windows XP Home oder Microsoft Windows XP Professional, sowohl mit Service Pack 2 oder höher.
Microsoft Windows Server 2003-Familie mit Service Pack 1 oder höher.

Für Microsoft Windows Vista (nicht einschließlich der IA64-Plattform) und Microsoft Windows Servercode namens "Longhorn" IA64 Edition ist .NET Framework 3.0 ein Feature des Betriebssystems.

Hardwareanforderungen

In der folgenden Tabelle sind die Hardwareanforderungen für die Ausführung von .NET Framework 3.0 aufgeführt.

	CPU erforderlich	RAM erforderlich
Minimum	Pentium 400 MHz	96 MB
Empfohlen	Pentium 1 GHz oder höher	256 MB oder mehr

Wo die .NET Framework 3.0 Redistributable Package abgerufen werden soll

Sie können Microsoft .NET Framework 3.0 redistributable package aus dem Microsoft Vista Download Center oder von der Microsoft Windows Update-Website herunterladen.

Hinweis Die Microsoft Windows Update-Website bietet nur die offiziell veröffentlichte Version der .NET Framework 3.0 an. Es bietet keine Betaversionen.

Wenn Sie die Microsoft-.NET Framework 3.0 im Internet installieren müssen, posten Sie das verteilbare Paket nicht im eigenen Netzwerk. Leiten Sie stattdessen Benutzer an das Microsoft Vista Download Center oder die Microsoft Windows Update-Website.

.NET Framework 3.0 mit einem Visual Studio 2005 Setup Project

Wenn Sie Anwendungen bereitstellen, die mit Visual Studio 2005 erstellt werden und .NET Framework 3.0 erfordern, muss die .NET Framework auf dem Zielcomputer installiert werden, bevor Ihre Anwendung installiert ist. Sie können die .NET Framework 3.0 in einer ausführbaren Setupdatei einschließen, die Sie mithilfe eines Visual Studio 2005-Setupprojekts erstellen. Wenn dies nicht praktisch ist, können Sie benutzer die .NET Framework manuell installieren, wie später beschrieben.

Wenn Sie ein Visual Studio 2005-Setupprojekt so konfigurieren, dass Microsoft .NET Framework 3.0 mit Ihrer Anwendung installiert wird, wird die .NET Framework 3.0 mit Ihrer Anwendung verpackt. Eine Startbedingung in der Setupbedingung Ihrer Anwendung überprüft, whether.NET Framework 3.0 installiert ist, und wenn erforderlich, installiert der Setupprozess die .NET Framework, bevor Sie Ihre Anwendung installieren. Microsoft .NET Framework 3.0 überprüft wiederum, whether.NET Framework 2.0 installiert ist. Wenn nicht, fordert der Setupvorgang den Benutzer auf, die frühere Version der .NET Framework zu installieren.

Um .NET Framework 3.0 mit dem Setupprozess Ihrer Anwendung einzuschließen, muss die optionale Visual Studio Erweiterungen für .NET Framework 3.0 auf dem Computer installiert werden, auf dem Sie das Setupprojekt erstellen.

So ermitteln Sie, ob Visual Studio Erweiterungen für .NET Framework 3.0 installiert sind

Klicken Sie im Windows Systemsteuerung auf "Programme hinzufügen oder entfernen".
Überprüfen Sie im Dialogfeld "Programme hinzufügen" oder "Programme entfernen" die Liste "Derzeit installierte Programme" für Microsoft Visual Studio 2005-Erweiterungen für .NET Framework 3.0.

Wenn Visual Studio 2005-Erweiterungen für .NET Framework 3.0 nicht aufgeführt sind, können Sie das Erweiterungspaket als Teil der Entwicklungstools für WinFX herunterladen und installieren, die im Microsoft Visual Studio Codenamen "Orcas" Community Technology Preview – Entwicklungstools für WinFX verfügbar sind. Seite im Microsoft Download Center.

Wenn Sie sicher sind, dass Die Visual Studio Erweiterungen für .NET Framework 3.0-Paket auf Ihrem Computer installiert sind, können Sie ein Setupprojekt erstellen, das die .NET Framework 3.0 enthält.

So schließen Sie das .NET Framework 3.0 mit einem Setupprojekt ein.

Erstellen Sie in Visual Studio 2005 ein neues Setupprojekt mit den folgenden Schritten:
1. Klicken Sie im Menü "Datei" auf "Neu", und klicken Sie dann auf Project.
2. Wählen Sie unter "Andere Project Typen" die Option "Setup" und "Bereitstellung" aus.
3. Benennen Sie Ihr Projekt, und klicken Sie auf "OK".
Fügen Sie Ihre Projektausgabe, Zusammenführen von Modulen, Dateien und Assemblys hinzu.
Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, und klicken Sie dann auf "Eigenschaften".

Das Dialogfeld Eigenschaftenseiten wird angezeigt.
Klicken Sie auf "Voraussetzungen".
Aktivieren Sie das Kontrollkästchen "Setup erstellen", um erforderliche Komponenten zu installieren .
Suchen Sie in der Liste Microsoft .NET Framework 3.0, und wählen Sie dann die für die Zielplattformen geeignete Version aus.
Geben Sie den Quellspeicherort für die Voraussetzungen an.

Für den Speicherort der .NET Framework 3.0 können Sie entweder die Windows Vista-Downloadwebsite oder eine eigene Website angeben. Die URL kann auch eine CD angeben, auf der Ihre eigene Anwendung verteilt wird.
Klicken Sie auf OK.

Benutzer installieren die .NET Framework manuell

In einigen Situationen kann es unpraktisch sein, dass Sie die .NET Framework 3.0 automatisch mit Ihrer Anwendung installieren. In diesem Fall können Sie .NET Framework von den Benutzern selbst installieren lassen. Die Redistributable ist aus mehreren Quellen verfügbar, wie weiter oben im Abschnitt "Abrufen the.NET Framework 3.0 Redistributable Package" beschrieben. Sie sollten jedoch nicht davon ausgehen, dass Benutzer Ihrer Anwendung wissen, wo sie abgerufen werden oder wie sie installiert werden. Im Setupprozess stellen Sie Anweisungen dafür bereit, wie Benutzer zur Suche und Installation von .NET Framework vorgehen müssen.

Verketten des Redistributable-Pakets in Ihrem Anwendungseinrichtung

Wenn Sie kein Visual Studio Setupprojekt erstellen möchten oder Benutzer die .NET Framework 3.0 manuell installieren möchten, können Sie den .NET Framework 3.0-Installationsprozess als Teil Ihrer eigenen Anwendungseinrichtung verketten. Um den .NET Framework 3.0-Installationsvorgang zu verketten, können Sie die Redistributable aus der Befehlszeile ausführen und die folgende Option für die automatische Installation verwenden:

/q /norestart

Weiterverteiler .NET Framework 3.0 für Webanwendungen

In webbasierten Anwendungen, die auf .NET Framework 3.0-Features basieren, muss die .NET Framework möglicherweise auf dem Computer des Benutzers heruntergeladen und installiert werden. Sie können bestimmen, ob .NET Framework 3.0 auf dem Computer des Benutzers installiert ist, indem Sie die Benutzer-Agent-Zeichenfolge im Browserheader abfragen. Wenn die richtige Version der .NET Framework nicht installiert ist, können Sie Benutzer zum .NET Framework 3.0 Download Center leiten, um das .NET Framework 3.0-Paket abzurufen.

Erkennen von Microsoft .NET Framework 3.0

Sie können erkennen, ob die .NET Framework 3.0 installiert ist, indem Sie einen Registrierungsschlüssel lesen und die Benutzer-Agent-Zeichenfolge in Internet Explorer abfragen.

Lesen von Registrierungsschlüsseln

Der .NET Framework 3.0-Installationsprogramm schreibt Registrierungsschlüssel, wenn die Installation erfolgreich ist. Sie können testen, whether.NET Framework 3.0 installiert ist, indem Sie die registrierungsschlüssel überprüfen, die in der folgenden Tabelle aufgeführt sind.

Registrierungsschlüsselname Wert

Registrierungsschlüsselname	Wert
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup`	Name: `InstallSuccess` Typ: DWORD Daten: `1`
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform`	Name: `Version` Typ: REG_SZ Daten: `.NET CLR 3.0.build number`

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup

Name: InstallSuccess

Typ: DWORD

Daten: 1

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform

Name: Version

Typ: REG_SZ

Daten: .NET CLR 3.0.build number

Lesen der Benutzer-Agent-Zeichenfolge in Internet Explorer

Wenn .NET Framework 3.0 auf einem Computer installiert ist, wird die .NET Framework 3.0-Versionsnummer als Teil der in Browserheadern gemeldeten Benutzer-Agent-Zeichenfolge angezeigt. Das folgende Beispiel zeigt eine Beispielseite, die JavaScript zum Erkennen und Melden verwendet, whether.NET Framework 3.0 installiert ist.

Hinweis Diese Beispielseite erfordert Internet Explorer.

<HTML>
  <HEAD>
    <TITLE>Test for .NET Framework 3.0</TITLE>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8" />
    <SCRIPT LANGUAGE="JavaScript">
    <!--
    var NETFX3RuntimeVersion = "3.0.50727";
    
    function window::onload()
    {
      if (HasRuntimeVersion(NETFX3RuntimeVersion))
      {
result.innerText = "This machine has the correct version of the .NET 
Framework 3.0 runtime: " + NETFX3RuntimeVersion + "."  + "\n\nThis 
machine's userAgent string is: " + navigator.userAgent + ".";
      } 
      else
      {
        document.write("The .NET Framework version 3.0 is not installed on this computer.<br/>"
+ "<a href='https://msdn.microsoft.com/windowsvista/default.aspx'>"
+ "Click here to get</a> .NET Framework 3.0 now.");      }
    }
    
    //
    // Retrieve the version from the user agent string and compare with specified version.
    //
    function HasRuntimeVersion(versionToCheck)
    {
      var userAgentString = navigator.userAgent.match(/.NET Framework 3.0 RunTime [0-9.]+/g);

      if (userAgentString != null)
      {
        var i;

        for (i = 0; i < userAgentString.length; ++i)
        {
          if (CompareVersions(GetVersion(versionToCheck), GetVersion(userAgentString[i])) <= 0)
            return true;
        }
      }

      return false;
    }

    //
    // Extract the numeric part of the version string.
    //
    function GetVersion(versionString)
    {
      var numericString = versionString.match(/([0-9]+)\.([0-9]+)\.([0-9]+)/i);
      return numericString.slice(1);
    }

    //
    // Compare the version strings by converting them to numeric format.
    //
    function CompareVersions(version1, version2)
    {
      for (i = 0; i < version1.length; ++i)
      {
        var number1 = new Number(version1[i]);
        var number2 = new Number(version2[i]);

        if (number1 < number2)
          return -1;

        if (number1 > number2)
          return 1;
      }

      return 0;
    }
    
    -->
    </SCRIPT>
  </HEAD>
  
  <BODY>
    <div id="result" />
  </BODY>
</HTML>

Wenn die Suche nach der Zeichenfolge ".NET Framework 3.0"-Version erfolgreich ist, wird die folgende Meldung angezeigt:

This machine has the correct version of the .NET Framework 3.0: 3.0.50727.
This machine's userAgent string is: Mozilla/4.0 (compatible; MSIE 6.0; 
Windows NT 5.1; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727; .NET CLR 
3.0.50727).

Andernfalls wird die folgende Meldung angezeigt:

The .NET Framework version 3.0 is not installed on this computer.
Click here to get the .NET Framework 3.0 now.

Befehlszeilenoptionen für die .NET Framework 3.0 Redistributable

In der folgenden Tabelle sind Optionen aufgeführt, die Sie einschließen können, wenn Sie das .NET Framework 3.0-Installationsprogramm (Dotnetfx3.exe, Dotnetfx3_x64.exe oder Dotnet3setup.exe) über die Befehlszeile ausführen.

Option	Beschreibung
`/q`	Unterdrückt alle Benutzeroberfläche. Mit dieser Option kann keine .INI Datei angegeben werden.
`/quiet`	Wie in `/q`.
`/qb`	Zeigt minimale Benutzeroberfläche an, wobei nur der Fortschritt angezeigt wird.
`/passive`	Wie in `/qb`.
`/uninstall`	Deinstalliert produkt.
`/remove`	Wie in `/uninstall`.
`/f`	Repariert alle installierten .NET Framework 3.0-Komponenten.
`/nopatch`	Gibt an, dass Patches nicht angewendet und die Patchüberprüfung umgangen werden.
`/norollback`	Gibt an, dass setup nicht zurückgesetzt wird, wenn eine Setupkomponente fehlschlägt.
`/norestart`	Gibt an, dass das Installationsprogramm den Computer nach Abschluss der Installation nicht neu startet. Der Verteilerinstallationsprogramm gibt ERROR_SUCCESS_REBOOT_REQUIRED (3010) zurück, wenn ein Neustart erforderlich ist.
`/?`	Zeigt diese Liste der Optionen an.

Fehlercodes für die .NET Framework 3.0 Redistributable

In der folgenden Tabelle sind Fehlercodes aufgeführt, die vom .NET Framework 3.0-Installationsprogramm (Dotnetfx3.exe, Dotnetfx3_x64.exe oder Dotnet3setup.exe) zurückgegeben werden können. Die Fehlercodes sind für alle Versionen des Installers identisch.

Fehlercode	Wert	Beschreibung
`ERROR_SUCCESS`	0	Die Aktion wurde erfolgreich abgeschlossen.
`ERROR_INSTALL_USEREXIT`	1602	Die Installation des Benutzers wurde abgebrochen.
`ERROR_INSTALL_FAILURE`	1603	Während der Installation ist ein schwerwiegender Fehler aufgetreten.
`ERROR_UNKNOWN_PRODUCT`	1605	Diese Aktion ist nur für Produkte gültig, die derzeit installiert sind.
`ERROR_PATCH_PACKAGE_INVALID`	1636	Das Patchpaket konnte nicht geöffnet werden, oder der Patch gilt nicht für .NET Framework 3.0.
`ERROR_INVALID_COMMAND_LINE`	1639	Ungültiges Befehlszeilenargument.
`ERROR_SUCCESS_REBOOT_INITIATED`	1641	Das Installationsprogramm hat einen Neustart initiiert. Dies gibt den Erfolg an, und das Setup wird nach dem Neustart fortgesetzt. (Der Neustart wird nicht ausgeführt, wenn die `/norestart` Option angegeben wurde.)
`ERROR_PATCH_PACKAGE_REJECTED`	1643	Das Patchpaket ist von der Systemrichtlinie nicht zulässig.
`ERROR_SUCCESS_REBOOT_REQUIRED`	3010	Ein Neustart ist erforderlich, um die Installation abzuschließen. Diese Meldung zeigt eine erfolgreiche Installation an.