Przewodnik wdrażania usługi Microsoft .NET Framework 3.0

Artykuł
05/11/2010

Microsoft Corporation

Lipiec 2006 r.

Zawartość

Podsumowanie
Wprowadzenie
Wymogi dotyczące instalacji
   Wymagania programowe
   Wymagania sprzętowe
Gdzie uzyskać pakiet redystrybucyjny .NET Framework 3.0
Ponowne dystrybuowanie .NET Framework 3.0 przy użyciu projektu instalacyjnego programu Visual Studio 2005
Ręczne instalowanie .NET Framework przez użytkowników
Łączenie łańcucha pakietu redystrybucyjnego w instalatorze aplikacji
Ponowne dystrybuowanie .NET Framework 3.0 dla aplikacji internetowych
Wykrywanie usługi Microsoft .NET Framework 3.0
   Odczytywanie kluczy rejestru
   Odczytywanie ciągu agenta użytkownika w programie Internet Explorer
Opcje wiersza polecenia dla pakietu redystrybucyjnego .NET Framework 3.0
Kody błędów pakietu redystrybucyjnego .NET Framework 3.0

Podsumowanie

W tym artykule opisano sposób wdrażania aplikacji microsoft .NET Framework 3.0 przy użyciu Dotnetfx3.exe, pakietu redystrybucyjnego .NET Framework 3.0. (10 drukowanych stron)

Uwaga Ta dokumentacja może zawierać informacje dotyczące scenariuszy, które omawiają dystrybucję, ale dokumentacja nie udziela Użytkownikowi żadnych praw do używania ani rozpowszechniania jakiejkolwiek części składników. Korzystanie z składników podlega umowie licencyjnej składników. Zapoznaj się z umową licencyjną Składniki, aby zrozumieć twoje prawa i warunki użytkowania.

Wprowadzenie

Program Microsoft.NET Framework 3.0 udostępnia instalatora redystrybucyjnego, który zawiera powiązania .NET Framework 2.0 z wymaganymi interfejsami API systemu Windows Vista do uruchamiania aplikacji .NET Framework 3.0.

Pakiet redystrybucyjny .NET Framework 3.0 jest dostępny jako autonomiczny plik wykonywalny. Nazwa pliku zależy od typu platformy docelowej. W przypadku platform 32-bitowych plik nosi nazwę Dotnetfx3.exe. W przypadku platform 64-bitowych plik nosi nazwę Dotnetfx3_x64.exe. Można również wdrożyć mały pakiet redystrybucyjny o nazwie Dotnet3setup.exe, który pobiera wymagane składniki podczas instalacji.

Uwaga Obsługa IA64 w .NET Framework 3.0 jest ograniczona do kodu o nazwie "Longhorn" systemu Microsoft Windows Server. Longhorn zawiera już .NET Framework 3.0, więc nie jest konieczny pakiet redystrybucyjny.

Możesz ręcznie uruchomić i zainstalować pakiet redystrybucyjny na komputerze lub można go uruchomić i zainstalować w ramach programu instalacyjnego dla aplikacji .NET Framework 3.0.

Uwaga Uprawnienia administratora są wymagane do zainstalowania .NET Framework 3.0.

Wymogi dotyczące instalacji

W tej sekcji opisano wymagania dotyczące oprogramowania i sprzętu dla komputera, na którym ma zostać zainstalowany pakiet redystrybucyjny microsoft .NET Framework 3.0. Jeśli minimalne wymagania nie zostaną spełnione, Dotnetfx3.exe zablokuje instalację pakietu redystrybucyjnego.

Wymagania programowe

Aby zainstalować program Microsoft .NET Framework 3.0, na komputerze docelowym należy zainstalować jeden z następujących systemów operacyjnych:

Microsoft Windows XP Home lub Microsoft Windows XP Professional, zarówno z dodatkiem Service Pack 2, jak i nowszym.
Rodzina systemów Microsoft Windows Server 2003 z dodatkiem Service Pack 1 lub nowszym.

W przypadku systemu Microsoft Windows Vista (w tym platformy IA64) i microsoft Windows Server o nazwie "Longhorn" IA64 Edition, .NET Framework 3.0 jest funkcją systemu operacyjnego.

Wymagania sprzętowe

W poniższej tabeli wymieniono wymagania sprzętowe dotyczące uruchamiania .NET Framework 3.0.

	Wymagany procesor CPU	Wymagana pamięć RAM
Minimum	Pentium 400 MHz	96 MB
Zalecane	Procesor Pentium 1 GHz lub nowszy	256 MB lub więcej

Gdzie uzyskać pakiet redystrybucyjny .NET Framework 3.0

Pakiet redystrybucyjny microsoft .NET Framework 3.0 można pobrać z Centrum pobierania Microsoft Vista lub z witryny sieci Web microsoft Windows Update.

Uwaga Witryna microsoft Windows Update oferuje tylko oficjalnie wydaną wersję .NET Framework 3.0; nie oferuje wersji beta.

Jeśli musisz mieć użytkowników, którzy instalują pakiet Microsoft .NET Framework 3.0 z Internetu, nie publikuj pakietu redystrybucyjnego we własnej sieci. Zamiast tego przekierowuje użytkowników do Centrum pobierania Microsoft Vista lub witryny sieci Web microsoft Windows Update.

Ponowne dystrybuowanie .NET Framework 3.0 przy użyciu projektu instalacyjnego programu Visual Studio 2005

Podczas wdrażania aplikacji utworzonych przy użyciu programu Visual Studio 2005 i wymagających .NET Framework 3.0 .NET Framework należy zainstalować na komputerze docelowym przed zainstalowaniem aplikacji. Można dołączyć .NET Framework 3.0 do pliku wykonywalnego konfiguracji utworzonego przy użyciu projektu instalacyjnego programu Visual Studio 2005. Jeśli nie jest to praktyczne, użytkownicy mogą ręcznie zainstalować .NET Framework zgodnie z opisem w dalszej części.

Podczas konfigurowania projektu instalacyjnego programu Visual Studio 2005 w celu zainstalowania programu Microsoft .NET Framework 3.0 z aplikacją .NET Framework 3.0 zostanie spakowany przy użyciu aplikacji. Warunek uruchamiania w instalacji aplikacji sprawdza, czy program whether.NET Framework 3.0 jest zainstalowany, a w razie potrzeby proces instalacji instaluje .NET Framework przed zainstalowaniem aplikacji. Z kolei program Microsoft .NET Framework 3.0 sprawdza, czy program whether.NET Framework 2.0 jest zainstalowany. W przeciwnym razie proces instalacji monituje użytkownika o zainstalowanie wcześniejszej wersji .NET Framework.

Aby dołączyć .NET Framework 3.0 do procesu instalacji aplikacji, opcjonalne rozszerzenia programu Visual Studio dla .NET Framework 3.0 muszą być zainstalowane na komputerze, na którym tworzysz projekt instalacyjny.

Aby ustalić, czy są zainstalowane rozszerzenia programu Visual Studio dla .NET Framework 3.0

W Panel sterowania systemu Windows kliknij pozycję Dodaj lub Usuń programy.
W oknie dialogowym Dodawanie lub usuwanie programów sprawdź listę Aktualnie zainstalowanych programów dla rozszerzeń programu Microsoft Visual Studio 2005 dla .NET Framework 3.0.

Jeśli rozszerzenia programu Visual Studio 2005 dla .NET Framework 3.0 nie są wymienione na liście, możesz pobrać i zainstalować pakiet rozszerzeń w ramach narzędzia programistycznego dla winFX, dostępnego na stronie Microsoft Visual Studio Code Name "Orcas" Community Technology Preview — Development Tools for WinFX w Centrum pobierania Microsoft.

Jeśli na komputerze masz zainstalowane rozszerzenia programu Visual Studio dla .NET Framework 3.0, możesz utworzyć projekt instalacyjny zawierający .NET Framework 3.0.

Aby dołączyć .NET Framework 3.0 do projektu instalacyjnego

W programie Visual Studio 2005 utwórz nowy projekt instalacyjny, wykonując następujące kroki:
1. W menu Plik kliknij pozycję Nowy, a następnie kliknij pozycję Projekt.
2. W obszarze Inne typy projektów wybierz pozycję Konfiguracja i wdrożenie.
3. Nadaj projektowi nazwę i kliknij przycisk OK.
Dodaj dane wyjściowe projektu, scal moduły, pliki i zestawy.
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy nazwę projektu, a następnie kliknij polecenie Właściwości.

Wyświetli się okno dialogowe Strony właściwości.
Kliknij pozycję Wymagania wstępne.
Zaznacz pole wyboru Utwórz program instalacyjny, aby zainstalować składniki wymagań wstępnych .
Na liście znajdź pozycję Microsoft .NET Framework 3.0, a następnie wybierz wersję odpowiednią dla platform docelowych.
Określ lokalizację źródłową wymagań wstępnych.

W przypadku lokalizacji .NET Framework 3.0 można określić witrynę pobierania systemu Windows Vista lub własną witrynę. Adres URL może również określać dysk CD, na którym jest dystrybuowana twoja własna aplikacja.
Kliknij przycisk OK.

Ręczne instalowanie .NET Framework przez użytkowników

W niektórych sytuacjach może to być niepraktyczne, aby automatycznie zainstalować .NET Framework 3.0 przy użyciu aplikacji. W takim przypadku użytkownicy mogą samodzielnie zainstalować .NET Framework. Pakiet redystrybucyjny jest dostępny z kilku źródeł, jak wspomniano wcześniej w sekcji Gdzie uzyskać pakiet redystrybucyjny programu the.NET Framework 3.0. Nie należy jednak zakładać, że użytkownicy aplikacji wiedzą, gdzie ją uzyskać lub jak ją zainstalować. W procesie konfiguracji podaj instrukcje dotyczące sposobu lokalizowania i instalowania .NET Framework przez użytkowników.

Łączenie łańcucha pakietu redystrybucyjnego w instalatorze aplikacji

Jeśli nie chcesz tworzyć projektu instalacyjnego programu Visual Studio lub użytkownicy instalują .NET Framework 3.0 ręcznie, możesz utworzyć łańcuch .NET Framework 3.0 procesu instalacji w ramach własnej konfiguracji aplikacji. Aby połączyć łańcuch procesu instalacji .NET Framework 3.0, możesz uruchomić redystrybucyjny z poziomu wiersza polecenia i użyć następującej opcji wiersza polecenia instalacji dyskretnej:

/q /norestart

Ponowne dystrybuowanie .NET Framework 3.0 dla aplikacji internetowych

W aplikacjach opartych na sieci Web, które korzystają z funkcji .NET Framework 3.0, może być konieczne pobranie i zainstalowanie .NET Framework na komputerze użytkownika. Możesz określić, czy na komputerze użytkownika jest zainstalowana .NET Framework 3.0, wysyłając zapytanie o ciąg agenta użytkownika w nagłówku przeglądarki. Jeśli nie zainstalowano poprawnej wersji .NET Framework, możesz skierować użytkowników do Centrum pobierania .NET Framework 3.0, aby uzyskać pakiet .NET Framework 3.0.

Wykrywanie usługi Microsoft .NET Framework 3.0

Możesz wykryć, czy .NET Framework 3.0 jest zainstalowana, odczytując klucz rejestru i wysyłając zapytanie o ciąg agenta użytkownika w programie Internet Explorer.

Odczytywanie kluczy rejestru

Instalator .NET Framework 3.0 zapisuje klucze rejestru po pomyślnym zakończeniu instalacji. Możesz przetestować whether.NET Framework 3.0 jest zainstalowany, sprawdzając klucze rejestru wymienione w poniższej tabeli.

Nazwa klucza rejestru Wartość

Nazwa klucza rejestru	Wartość
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup`	Nazwa: `InstallSuccess` Typ: DWORD Dane: `1`
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform`	Nazwa: `Version` Typ: REG_SZ Dane: `.NET CLR 3.0.build number`

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

Nazwa: InstallSuccess

Typ: DWORD

Dane: 1

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

Nazwa: Version

Typ: REG_SZ

Dane: .NET CLR 3.0.build number

Odczytywanie ciągu agenta użytkownika w programie Internet Explorer

Po zainstalowaniu .NET Framework 3.0 na komputerze numer wersji .NET Framework 3.0 jest wyświetlany jako część ciągu agenta użytkownika zgłoszonego w nagłówkach przeglądarki. W poniższym przykładzie pokazano przykładową stronę, która używa języka JavaScript do wykrywania i raportowania whether.NET Framework 3.0 jest zainstalowana.

Uwaga Ta przykładowa strona wymaga programu 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>

Jeśli wyszukiwanie ciągu ".NET Framework 3.0" zakończy się pomyślnie, zostanie wyświetlony następujący komunikat:

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

W przeciwnym razie zostanie wyświetlony następujący komunikat:

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

Opcje wiersza polecenia dla pakietu redystrybucyjnego .NET Framework 3.0

W poniższej tabeli wymieniono opcje, które można uwzględnić podczas uruchamiania programu instalacyjnego redystrybucyjnego .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe lub Dotnet3setup.exe) z wiersza polecenia.

Opcja	Opis
`/q`	Pomija cały interfejs użytkownika. Nie można określić pliku .INI z tą opcją.
`/quiet`	Tak samo jak `/q`.
`/qb`	Wyświetla minimalny interfejs użytkownika, pokazujący tylko postęp.
`/passive`	Tak samo jak `/qb`.
`/uninstall`	Odinstalowuje produkt.
`/remove`	Tak samo jak `/uninstall`.
`/f`	Naprawia wszystkie zainstalowane składniki .NET Framework 3.0.
`/nopatch`	Określa, że poprawki nie są stosowane i pomija sprawdzanie poprawek.
`/norollback`	Określa, że instalacja nie zostanie wycofana, jeśli składnik instalacyjny ulegnie awarii.
`/norestart`	Określa, że instalator nie uruchamia ponownie komputera po zakończeniu instalacji. Instalator pakietu redystrybucyjnego zwraca ERROR_SUCCESS_REBOOT_REQUIRED (3010), jeśli jest wymagany ponowny rozruch.
`/?`	Wyświetla tę listę opcji.

Kody błędów pakietu redystrybucyjnego .NET Framework 3.0

W poniższej tabeli wymieniono kody błędów, które mogą być zwracane przez program instalacyjny pakietu redystrybucyjnego .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe lub Dotnet3setup.exe). Kody błędów są takie same dla wszystkich wersji instalatora.

Kod błędu	Wartość	Opis
`ERROR_SUCCESS`	0	Akcja została ukończona pomyślnie.
`ERROR_INSTALL_USEREXIT`	1602	Użytkownik anulował instalację.
`ERROR_INSTALL_FAILURE`	1603	Podczas instalacji wystąpił błąd krytyczny.
`ERROR_UNKNOWN_PRODUCT`	1605	Ta akcja jest prawidłowa tylko w przypadku aktualnie zainstalowanych produktów.
`ERROR_PATCH_PACKAGE_INVALID`	1636	Nie można otworzyć pakietu poprawek lub poprawka nie ma zastosowania do .NET Framework 3.0.
`ERROR_INVALID_COMMAND_LINE`	1639	Nieprawidłowy argument wiersza polecenia.
`ERROR_SUCCESS_REBOOT_INITIATED`	1641	Instalator zainicjował ponowne uruchomienie. Oznacza to powodzenie, a konfiguracja będzie kontynuowana po ponownym uruchomieniu. (Ponowny rozruch nie jest wykonywany, jeśli `/norestart` określono opcję).
`ERROR_PATCH_PACKAGE_REJECTED`	1643	Pakiet poprawek nie jest dozwolony przez zasady systemowe.
`ERROR_SUCCESS_REBOOT_REQUIRED`	3010	Do ukończenia instalacji wymagane jest ponowne uruchomienie komputera. Ten komunikat oznacza sukces.

Udostępnij za pośrednictwem