Průvodce nasazením rozhraní Microsoft .NET Framework 3.0

Článek
05/11/2010

Microsoft Corporation

Dne

Obsah

Souhrn
Úvod
Požadavky na instalaci
   Požadavky na software
   Požadavky na hardware
Kde získat distribuovatelný balíček rozhraní .NET Framework 3.0
Redistribuce rozhraní .NET Framework 3.0 pomocí projektu instalace sady Visual Studio 2005
Ruční instalace rozhraní .NET Framework uživateli
Zřetězování distribuovatelného balíčku v nastavení aplikace
Redistribuce rozhraní .NET Framework 3.0 pro webové aplikace
Zjišťování rozhraní Microsoft .NET Framework 3.0
   Čtení klíčů registru
   Čtení řetězce user-agent v Internet Exploreru
Možnosti příkazového řádku pro .NET Framework 3.0 Redistributable
Kódy chyb pro .NET Framework 3.0 Redistributable

Souhrn

Tento článek popisuje, jak nasadit aplikace Microsoft .NET Framework 3.0 s Dotnetfx3.exe, distribuovatelný balíček rozhraní .NET Framework 3.0. (10 vytištěných stránek)

Poznámka Tato dokumentace může obsahovat informace pro scénáře, které popisují distribuci, ale tato dokumentace vám neuděluje žádná práva k používání nebo distribuci jakékoli části součástí. Vaše používání komponent podléhá licenční smlouvě pro komponenty. Přečtěte si licenční smlouvu s komponentami, abyste porozuměli vašim právům a podmínkám použití.

Úvod

Microsoft.NET Framework 3.0 poskytuje distribuovatelný instalační program, který obsahuje vazby rozhraní .NET Framework 2.0 na požadovaná rozhraní API systému Windows Vista pro spouštění aplikací rozhraní .NET Framework 3.0.

Distribuovatelný balíček rozhraní .NET Framework 3.0 je k dispozici jako samostatný spustitelný soubor. Název souboru závisí na typu cílové platformy. Pro 32bitové platformy má soubor název Dotnetfx3.exe. Pro 64bitové platformy má soubor název Dotnetfx3_x64.exe. Můžete také nasadit malý distribuovatelný balíček s názvem Dotnet3setup.exe, který během instalace stáhne požadované komponenty.

Poznámka Podpora IA64 v rozhraní .NET Framework 3.0 je omezená na Microsoft Windows Server s kódem s názvem Longhorn. Longhorn již obsahuje rozhraní .NET Framework 3.0, takže není potřeba distribuovatelný balíček.

Distribuovatelné zařízení můžete spustit a nainstalovat na počítači ručně, nebo ho můžete spustit a nainstalovat jako součást instalačního programu pro aplikaci rozhraní .NET Framework 3.0.

Poznámka K instalaci rozhraní .NET Framework 3.0 se vyžadují oprávnění správce.

Požadavky na instalaci

Tato část popisuje požadavky na software a hardware pro počítač, ve kterém se má nainstalovat distribuovatelný balíček Microsoft .NET Framework 3.0. Pokud nejsou splněny minimální požadavky, Dotnetfx3.exe zablokuje instalaci distribuovatelného balíčku.

Požadavky na software

Chcete-li nainstalovat rozhraní Microsoft .NET Framework 3.0, musí být v cílovém počítači nainstalován jeden z následujících operačních systémů:

Microsoft Windows XP Home nebo Microsoft Windows XP Professional, oba s aktualizací Service Pack 2 nebo novější.
Řady Microsoft Windows Server 2003 s aktualizací Service Pack 1 nebo novější.

Pro Systémy Microsoft Windows Vista (bez platformy IA64) a Microsoft Windows Server s kódovým názvem Longhorn IA64 Edition je rozhraní .NET Framework 3.0 funkcí operačního systému.

Požadavky na hardware

Následující tabulka uvádí požadavky na hardware pro spuštění rozhraní .NET Framework 3.0.

	Vyžaduje se procesor.	Vyžaduje se paměť RAM.
Minimum	Pentium 400 MHz	96 MB
Doporučeno	Pentium 1 GHz nebo vyšší	256 MB nebo více

Kde získat distribuovatelný balíček rozhraní .NET Framework 3.0

Distribuovatelný balíček rozhraní Microsoft .NET Framework 3.0 si můžete stáhnout z webu Microsoft Vista Download Center nebo z webu Microsoft služba Windows Update.

Poznámka Web Microsoft služba Windows Update nabízí pouze oficiálně vydanou verzi rozhraní .NET Framework 3.0; nenabízí beta verze.

Pokud potřebujete, aby uživatelé nainstalovali rozhraní Microsoft .NET Framework 3.0 z internetu, nezmisílujte distribuovatelný balíček ve vlastní síti. Místo toho nasměrujte uživatele na web Microsoft Vista Download Center nebo microsoft služba Windows Update.

Redistribuce rozhraní .NET Framework 3.0 pomocí projektu instalace sady Visual Studio 2005

Při nasazení aplikací, které jsou vytvořeny pomocí sady Visual Studio 2005 a které vyžadují rozhraní .NET Framework 3.0, musí být rozhraní .NET Framework nainstalováno v cílovém počítači před instalací aplikace. Rozhraní .NET Framework 3.0 můžete zahrnout do instalačního spustitelného souboru, který vytvoříte pomocí projektu instalace sady Visual Studio 2005. Pokud to není praktické, můžete uživatele nechat nainstalovat rozhraní .NET Framework ručně, jak je popsáno dále.

Když nakonfigurujete projekt instalace sady Visual Studio 2005 pro instalaci rozhraní Microsoft .NET Framework 3.0 s vaší aplikací, je rozhraní .NET Framework 3.0 zabaleno s vaší aplikací. Podmínka spuštění v instalačním programu aplikace zkontroluje, whether.NET Framework 3.0 je nainstalována, a v případě potřeby instalační proces nainstaluje rozhraní .NET Framework před instalací aplikace. Rozhraní Microsoft .NET Framework 3.0 zase kontroluje, whether.NET Framework 2.0 je nainstalován. Pokud ne, instalační proces vyzve uživatele k instalaci starší verze rozhraní .NET Framework.

Chcete-li zahrnout rozhraní .NET Framework 3.0 do procesu instalace aplikace, musí být volitelná rozšíření Sady Visual Studio pro .NET Framework 3.0 nainstalována v počítači, kde vytváříte projekt instalace.

Zjištění, jestli jsou nainstalovaná rozšíření sady Visual Studio pro rozhraní .NET Framework 3.0

V Ovládací panely Windows klikněte na Přidat nebo odebrat programy.
V dialogovém okně Přidat nebo odebrat programy zkontrolujte seznam Aktuálně nainstalované programy pro Rozšíření sady Microsoft Visual Studio 2005 pro rozhraní .NET Framework 3.0.

Pokud není v seznamu uvedena rozšíření sady Visual Studio 2005 pro .NET Framework 3.0, můžete stáhnout a nainstalovat balíček rozšíření jako součást vývojových nástrojů pro WinFX, které jsou k dispozici na stránce Microsoft Visual Studio Code Name "Orcas" Community Technology Preview – Vývojové nástroje pro WinFX na webu Microsoft Download Center.

Pokud jste si jistí, že máte v počítači nainstalovaný balíček Rozšíření sady Visual Studio pro rozhraní .NET Framework 3.0, můžete vytvořit projekt instalace, který obsahuje rozhraní .NET Framework 3.0.

Zahrnutí rozhraní .NET Framework 3.0 do projektu instalace

V sadě Visual Studio 2005 vytvořte nový projekt instalace pomocí těchto kroků:
1. V nabídce File (Soubor) klikněte na New (Nový) a potom klikněte na Project (Projekt).
2. V části Jiné typy projektů vyberte Nastavení a nasazení.
3. Pojmenujte projekt a klikněte na OK.
Přidejte výstup projektu, slučujte moduly, soubory a sestavení.
V Průzkumník řešení klikněte pravým tlačítkem myši na název projektu a potom klikněte na Vlastnosti.

Zobrazí se dialogové okno Stránky vlastností.
Klikněte na Požadavky.
Zaškrtněte políčko Vytvořit instalační program pro instalaci požadovaných součástí .
V seznamu vyhledejte Rozhraní Microsoft .NET Framework 3.0 a pak vyberte verzi vhodnou pro cílové platformy.
Zadejte zdrojové umístění pro požadavky.

Pro umístění rozhraní .NET Framework 3.0 můžete určit buď web pro stažení systému Windows Vista, nebo vlastní web. Adresa URL může také určit disk CD, na kterém se distribuuje vaše vlastní aplikace.
Klikněte na OK.

Ruční instalace rozhraní .NET Framework uživateli

V některých situacích může být nepraktické, abyste automaticky nainstalovali rozhraní .NET Framework 3.0 s vaší aplikací. V takovém případě můžete uživatele nechat nainstalovat rozhraní .NET Framework sami. Distribuovatelný balíček je k dispozici z několika zdrojů, jak je uvedeno výše v části Kde získat the.NET Framework 3.0 Redistributable Package. Neměli byste však předpokládat, že uživatelé vaší aplikace vědí, kde ji získat nebo jak ji nainstalovat. V procesu instalace zadejte pokyny, jak by uživatelé měli najít a nainstalovat rozhraní .NET Framework.

Zřetězování distribuovatelného balíčku v nastavení aplikace

Pokud nechcete vytvořit projekt instalace sady Visual Studio nebo chcete, aby uživatelé nainstalovali rozhraní .NET Framework 3.0 ručně, můžete zřetězovat proces instalace rozhraní .NET Framework 3.0 jako součást vlastního nastavení aplikace. Chcete-li zřetězit proces instalace rozhraní .NET Framework 3.0, můžete spustit distribuovatelné z příkazového řádku a použít následující možnost příkazového řádku bezobslužné instalace:

/q /norestart

Redistribuce rozhraní .NET Framework 3.0 pro webové aplikace

Ve webových aplikacích, které jsou závislé na funkcích rozhraní .NET Framework 3.0, může být nutné stáhnout a nainstalovat rozhraní .NET Framework do počítače uživatele. Můžete zjistit, zda je rozhraní .NET Framework 3.0 nainstalováno v počítači uživatele dotazováním řetězce uživatelského agenta v hlavičce prohlížeče. Pokud není nainstalována správná verze rozhraní .NET Framework, můžete uživatele směrovat na .NET Framework 3.0 Download Center , abyste získali balíček rozhraní .NET Framework 3.0.

Zjišťování rozhraní Microsoft .NET Framework 3.0

Pokud chcete zjistit, jestli je nainstalované rozhraní .NET Framework 3.0, můžete číst klíč registru a dotazovat se na řetězec uživatelského agenta v Internet Exploreru.

Čtení klíčů registru

Instalační program rozhraní .NET Framework 3.0 zapisuje klíče registru při úspěšné instalaci. Kontrolu klíčů registru uvedených v následující tabulce můžete otestovat, whether.NET framework 3.0 je nainstalovaný.

Název klíče registru Hodnota

Název klíče registru	Hodnota
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup`	Název: `InstallSuccess` Typ: DWORD Data: `1`
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform`	Název: `Version` Typ: REG_SZ Data: `.NET CLR 3.0.build number`

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

Název: InstallSuccess

Typ: DWORD

Data: 1

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

Název: Version

Typ: REG_SZ

Data: .NET CLR 3.0.build number

Čtení řetězce user-agent v Internet Exploreru

Při instalaci rozhraní .NET Framework 3.0 v počítači se číslo verze rozhraní .NET Framework 3.0 zobrazí jako součást řetězce uživatelského agenta hlášeného v hlavičce prohlížeče. Následující příklad ukazuje ukázkovou stránku, která používá JavaScript ke zjištění a hlášení whether.NET Framework 3.0 je nainstalován.

Poznámka Tato ukázková stránka vyžaduje 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>

Pokud je hledání řetězce ".NET Framework 3.0" verze úspěšné, zobrazí se následující zpráva:

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

V opačném případě se zobrazí následující zpráva:

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

Možnosti příkazového řádku pro .NET Framework 3.0 Redistributable

Následující tabulka uvádí možnosti, které můžete zahrnout při spuštění distribuovatelného instalačního programu rozhraní .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe nebo Dotnet3setup.exe) z příkazového řádku.

Možnost	Popis
`/q`	Potlačí veškeré uživatelské rozhraní. Pomocí této možnosti nelze zadat soubor .INI.
`/quiet`	Stejné jako `/q`.
`/qb`	Zobrazí minimální uživatelské rozhraní a zobrazuje pouze průběh.
`/passive`	Stejné jako `/qb`.
`/uninstall`	Odinstaluje produkt.
`/remove`	Stejné jako `/uninstall`.
`/f`	Opraví všechny nainstalované součásti rozhraní .NET Framework 3.0.
`/nopatch`	Určuje, že se nepoužijí opravy a obchází kontrolu oprav.
`/norollback`	Určuje, že instalační program se nevrátí zpět, pokud komponenta instalačního programu selže.
`/norestart`	Určuje, že instalační program po dokončení instalace nerestartuje počítač. Instalační program redistributable vrátí ERROR_SUCCESS_REBOOT_REQUIRED (3010), pokud je vyžadováno restartování.
`/?`	Zobrazí tento seznam možností.

Kódy chyb pro .NET Framework 3.0 Redistributable

Následující tabulka uvádí kódy chyb, které mohou být vráceny distribuovatelným instalačním programem rozhraní .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe nebo Dotnet3setup.exe). Kódy chyb jsou stejné pro všechny verze instalačního programu.

Kód chyby	Hodnota	Popis
`ERROR_SUCCESS`	0	Akce se úspěšně dokončila.
`ERROR_INSTALL_USEREXIT`	1602	Uživatel zrušil instalaci.
`ERROR_INSTALL_FAILURE`	1603	Při instalaci došlo k závažné chybě.
`ERROR_UNKNOWN_PRODUCT`	1605	Tato akce je platná pouze pro produkty, které jsou aktuálně nainstalované.
`ERROR_PATCH_PACKAGE_INVALID`	1636	Balíček opravy nelze otevřít nebo oprava nebyla použitelná pro rozhraní .NET Framework 3.0.
`ERROR_INVALID_COMMAND_LINE`	1639	Neplatný argument příkazového řádku
`ERROR_SUCCESS_REBOOT_INITIATED`	1641	Instalační program zahájil restartování. To značí úspěch a instalace bude po restartování pokračovat. (Restartování se neprovádí, pokud byla zadána `/norestart` možnost.)
`ERROR_PATCH_PACKAGE_REJECTED`	1643	Systémové zásady nepovolují balíček oprav.
`ERROR_SUCCESS_REBOOT_REQUIRED`	3010	K dokončení instalace je nutné provést restart. Tato zpráva znamená úspěch.

Sdílet prostřednictvím