Bereitstellungshandbuch für Microsoft .NET Framework 3.0

Artikel
05/11/2010

Microsoft Corporation

Juli 2006

Inhalte

Zusammenfassung
Einführung
Installationsanforderungen
   Softwareanforderungen
   Hardwareanforderungen
Abrufen des .NET Framework 3.0 Redistributable-Pakets
Verteilen von .NET Framework 3.0 mithilfe eines Visual Studio 2005-Setupprojekts
Benutzer müssen die .NET Framework manuell installieren
Verketten des verteilbaren Pakets in Ihrem Anwendungssetup
Verteilen von .NET Framework 3.0 für Webanwendungen
Erkennen von Microsoft .NET Framework 3.0
   Lesen von Registrierungsschlüsseln
   Lesen der User-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, dem .NET Framework verteilbaren Paket 3.0. (10 gedruckte Seiten)

Hinweis Diese Dokumentation kann Informationen für Szenarien enthalten, in denen die Verteilung erläutert wird, aber die Dokumentation gewährt Ihnen keine Rechte zur Verwendung oder Verteilung eines Teils der Komponenten. Ihre Nutzung der Komponenten unterliegt dem Lizenzvertrag für die Komponenten. Bitte lesen Sie den Lizenzvertrag 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 verteilbare Paket 3.0 ist als eigenständige ausführbare Datei verfügbar. Der Name der Datei hängt vom Typ der Zielplattform ab. Bei 32-Bit-Plattformen hat die Datei den Namen Dotnetfx3.exe. Bei 64-Bit-Plattformen hat die Datei den Namen Dotnetfx3_x64.exe. Sie können auch ein kleines verteilbares Paket mit dem Namen Dotnet3setup.exe bereitstellen, das die erforderlichen Komponenten während des Setups herunterlädt.

Hinweis Die IA64-Unterstützung in .NET Framework 3.0 ist auf den Microsoft Windows Server-Code "Longhorn" beschränkt. Longhorn enthält bereits .NET Framework 3.0, sodass kein verteilbares Paket erforderlich ist.

Sie können die Verteilerversion 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 verteilbare 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 eines der folgenden Betriebssysteme auf dem Zielcomputer installiert sein:

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

Für Microsoft Windows Vista (ohne IA64-Plattform) und Microsoft Windows Server mit dem Codenamen "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

Abrufen des .NET Framework 3.0 Redistributable-Pakets

Sie können das verteilbare Microsoft .NET Framework 3.0-Paket 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 und bietet keine Betaversionen an.

Wenn Benutzer die Microsoft .NET Framework 3.0 aus dem Internet installieren müssen, veröffentlichen Sie das verteilbare Paket nicht in Ihrem eigenen Netzwerk. Leiten Sie Benutzer stattdessen zum Microsoft Vista Download Center oder zur Microsoft Windows Update-Website weiter.

Verteilen von .NET Framework 3.0 mithilfe eines Visual Studio 2005-Setupprojekts

Wenn Sie Anwendungen bereitstellen, die mit Visual Studio 2005 erstellt wurden und .NET Framework 3.0 erfordern, muss die .NET Framework auf dem Zielcomputer installiert werden, bevor Ihre Anwendung installiert wird. Sie können die .NET Framework 3.0 in eine ausführbare Setupdatei einschließen, die Sie mit einem Visual Studio 2005-Setupprojekt erstellen. Wenn dies nicht praktikabel ist, können Sie benutzer die .NET Framework manuell installieren, wie weiter unten beschrieben.

Wenn Sie ein Visual Studio 2005-Setupprojekt konfigurieren, um Microsoft .NET Framework 3.0 mit Ihrer Anwendung zu installieren, wird die .NET Framework 3.0 mit Ihrer Anwendung gepackt. Eine Startbedingung in der Einrichtung Ihrer Anwendung überprüft, whether.NET Framework 3.0 installiert ist, und falls erforderlich, installiert der Setupprozess die .NET Framework vor der Installation Der Anwendung. Microsoft .NET Framework 3.0 überprüft wiederum, whether.NET Framework 2.0 installiert ist. Andernfalls wird der Benutzer beim Setupvorgang aufgefordert, auch die frühere Version des .NET Framework zu installieren.

Um .NET Framework 3.0 in den Setupprozess Ihrer Anwendung einzubeziehen, müssen die optionalen Visual Studio-Erweiterungen für .NET Framework 3.0 auf dem Computer installiert sein, auf dem Sie das Setupprojekt erstellen.

So bestimmen 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 Software 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 ist, können Sie das Erweiterungspaket als Teil der Entwicklungstools für WinFX herunterladen und installieren, die auf der Seite Microsoft Visual Studio Code Name "Orcas" Community Technology Preview – Development Tools for WinFX im Microsoft Download Center verfügbar ist.

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

So schließen Sie die .NET Framework 3.0 in ein Setupprojekt ein

Erstellen Sie in Visual Studio 2005 mithilfe der folgenden Schritte ein neues Setupprojekt:
1. Klicken Sie im Menü Datei auf Neu und dann auf Projekt.
2. Wählen Sie unter Andere Projekttypendie Option Setup und Bereitstellung aus.
3. Benennen Sie Ihr Projekt, und klicken Sie auf OK.
Fügen Sie Ihre Projektausgabe, Mergemodule, 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 Setupprogramm erstellen, um erforderliche Komponenten zu installieren .
Suchen Sie in der Liste nach 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 des .NET Framework 3.0 können Sie entweder die Windows Vista Download-Website oder eine eigene Website angeben. Die URL kann auch eine CD angeben, auf der Ihre eigene Anwendung verteilt wird.
Klicken Sie auf OK.

Benutzer müssen die .NET Framework manuell installieren

In einigen Situationen kann es für Sie unpraktisch sein, die .NET Framework 3.0 automatisch mit Ihrer Anwendung zu installieren. In diesem Fall können Sie .NET Framework von den Benutzern selbst installieren lassen. Die Verteilerversion ist aus mehreren Quellen verfügbar, wie weiter oben im Abschnitt Where to Obtain the.NET Framework 3.0 Redistributable Package erwähnt. Sie sollten jedoch nicht davon ausgehen, dass Benutzer Ihrer Anwendung wissen, wo sie sie erhalten 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 verteilbaren Pakets in Ihrem Anwendungssetup

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-Installationsprozess zu verketten, können Sie die redistributable über die Befehlszeile ausführen und die folgende Befehlszeilenoption für die automatische Installation verwenden:

/q /norestart

Verteilen von .NET Framework 3.0 für Webanwendungen

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

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 User-Agent-Zeichenfolge in Internet Explorer abfragen.

Lesen von Registrierungsschlüsseln

Das .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 in der folgenden Tabelle aufgeführten Registrierungsschlüssel überprüfen.

Name des Registrierungsschlüssels Wert

Name des Registrierungsschlüssels	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 User-Agent-Zeichenfolge in Internet Explorer

Wenn .NET Framework 3.0 auf einem Computer installiert ist, wird die versionsnummer .NET Framework 3.0 als Teil der user-agent-Zeichenfolge angezeigt, die in Browserheadern gemeldet wird. Das folgende Beispiel zeigt eine Beispielseite, die JavaScript verwendet, um zu erkennen und zu melden, whether.NET Framework 3.0 installiert ist.

Hinweis Für diese Beispielseite ist internet Explorer erforderlich.

<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 war, 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 die gesamte Benutzeroberfläche. Mit dieser Option kann keine .INI Datei angegeben werden.
`/quiet`	Wie in `/q`.
`/qb`	Zeigt eine minimale Benutzeroberfläche an, die nur den Fortschritt anzeigt.
`/passive`	Wie in `/qb`.
`/uninstall`	Deinstalliert das Produkt.
`/remove`	Wie in `/uninstall`.
`/f`	Repariert alle installierten .NET Framework 3.0-Komponenten.
`/nopatch`	Gibt an, dass Patches nicht angewendet werden, und umgeht die Patchüberprüfung.
`/norollback`	Gibt an, dass beim Setup kein Rollback ausgeführt wird, wenn eine Setupkomponente fehlschlägt.
`/norestart`	Gibt an, dass das Installationsprogramm den Computer nach Abschluss der Installation nicht neu startet. Das Installationsprogramm redistributable 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 Installationsprogramms identisch.

Fehlercode	Wert	BESCHREIBUNG
`ERROR_SUCCESS`	0	Die Aktion wurde erfolgreich abgeschlossen.
`ERROR_INSTALL_USEREXIT`	1602	Die Installation wurde vom Benutzer 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 war nicht auf .NET Framework 3.0 anwendbar.
`ERROR_INVALID_COMMAND_LINE`	1639	Ungültiges Befehlszeilenargument.
`ERROR_SUCCESS_REBOOT_INITIATED`	1641	Das Installationsprogramm hat einen Neustart initiiert. Dies bedeutet, dass erfolgreich war, 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 laut 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.

Freigeben über