Руководство по развертыванию .NET Framework 3.5 для разработчиков приложений

Для платформы Microsoft .NET Framework версии 3.5 имеется распространяемый установщик, включающий также пакеты обновления и накопительные обновления для платформ .NET Framework версий 2.0 и 3.0.

Этот раздел рассказывает, как распространять .NET Framework вместе с приложениями. Он содержит следующие подразделы:

• Доступные форматы

• Где найти распространяемый пакет .NET Framework 3.5?

• Требования для установки

• Установка платформы .NET Framework вручную

• Включение установки распространяемого пакета в процесс установки приложения

• Установка .NET Framework 3.5 для веб-приложений

• Обнаружение .NET Framework 3.5

• Параметры командной строки

• Коды ошибок

• Приложение. Компоненты .NET Framework 3.5

• Приложение. Примеры установки

Доступные форматы

Распространяемый пакет .NET Framework 3.5 доступен в двух форматах.

• dotnetfx35.exe. Это автономный исполняемый файл, который содержит все компоненты, необходимые для развертывания 32- и 64-разрядных платформ на всех поддерживаемых операционных системах. Этот файл не включает языковые пакеты; по умолчанию он скачивает и устанавливает языковой пакет, соответствующий языку операционной системы пользователя. Языковые пакеты платформы .NET Framework версии 3.5 доступны в виде отдельных исполняемых файлов для каждого языка в Центре загрузки Майкрософт.

• dotnetfx35setup.exe. Это компактный загрузчик, который в процессе установки загружает необходимые компоненты из Интернета. Этот исполняемый файл не содержит каких-либо компонентов .NET Framework 3.5; он обнаруживает, загружает из Интернета и устанавливает только требуемые компоненты. Также загрузчик загружает и устанавливает языковой пакет, соответствующий языку операционной системы пользователя. Для установки поддержки дополнительных языков можно использовать отдельные языковые пакеты.

Любой пакет можно использовать как на 32-, так и на 64-разрядных платформах на всех поддерживаемых операционных системах.

Распространяемый пакет можно запустить и установить на компьютер вручную или в составе программы установки для приложения .NET Framework 3.5.

Примечание.
Для установки .NET Framework 3.5 требуются права администратора.

Где найти распространяемый пакет .NET Framework 3.5?

Распространяемый пакет Microsoft .NET Framework 3.5 можно загрузить в Центре загрузки Майкрософт. При нажатии кнопки Загрузить (в верхней части страницы) будет установлен загрузчик (dotNetFx35setup.exe). Чтобы загрузить полный пакет установки, прокрутите страницу вниз до ссылки на полный распространяемый пакет.

Требования для установки

В этом разделе описаны требования к оборудованию и программному обеспечению для установки платформы .NET Framework 3.5. Если компьютер не соответствует минимальным требованиям, установка .NET Framework будет остановлена.

Подробный список требований к оборудованию и программному обеспечению см. в разделе .Системные требования для версии 3.5.

Требования к программному обеспечению

На компьютере, на который устанавливается .NET Framework 3.5, должна быть установлена одна из следующих операционных систем.

• Windows XP Home или Windows XP Professional, обе системы с пакетом обновления 2 (SP2) или более поздней версии.

• Семейство Windows Server 2003 с пакетом обновления 1 (SP1) или более поздней версии.

• Windows Vista.

• Windows Server 2008.

  Примечание.
  Платформа .NET Framework 3.5 поддерживает IA64 только в ОС Microsoft Windows Server 2008.

Требования к оборудованию

В следующей таблице перечислены требования к процессору и оперативной памяти для .NET Framework 3.5.

Установка платформы .NET Framework вручную

Иногда автоматическая установка .NET Framework 3.5 вместе с приложением может оказаться не самым удобным вариантом. В таком случае пользователи могут сами устанавливать платформу .NET Framework из Центра загрузки Майкрософт. В процессе установки дайте пользователям указания, как найти и установить .NET Framework.

Примечание.
Не размещайте распространяемый пакет в своей сети. Вместо этого направляйте пользователей непосредственно в Центр загрузки Майкрософт.

Включение установки распространяемого пакета в процесс установки приложения

Есть три способа включения установки .NET Framework 3.5 в процесс установки приложения.

• Способ 1. Задать, чтобы в процессе установки .NET Framework автоматически определялся список требуемых компонентов, загружались из Интернета и устанавливались только эти компоненты.

  Чтобы в процессе установки .NET Framework автоматически определить, загрузить и установить только необходимые компоненты, следует использовать пакет dotnetfx35setup.exe. Чтобы включить установку .NET Framework в процесс установки приложения, добавьте в этот процесс следующую команду:

  dotnetfx35setup.exe /q /norestart

• Способ 2. Поместить полный набор файлов .NET Framework на распространяемый носитель, чтобы в процессе установки пользователям не пришлось загружать дополнительные файлы из Интернета.

  Для включения в процесс установки всех компонентов .NET Framework используйте автономный исполняемый файл (dotnetfx35.exe). Этот пакет содержит компоненты, необходимые для установки .NET Framework 3.5 на компьютерах с архитектурой x86, x64 и IA64 на всех поддерживаемых операционных системах. Этот пакет можно использовать, если свободное место на диске и время загрузки не играют роли при развертывании приложения. Чтобы включить установку .NET Framework в процесс установки приложения, воспользуйтесь следующей командой:

  dotnetfx35.exe /q /norestart

• Способ 3. Включить в распространяемый среди пользователей пакет компоненты .NET Framework, которые требуются чаще всего; в процессе установки автоматически определить недостающие компоненты и загрузить их из Интернета. Этот вариант является оптимальным, если приложение развертывается на конкретной платформе, в конкретной операционной системе или в конкретной конфигурации пользовательской системы.

  Для выполнения установки такого типа необходимо сначала получить автономный исполняемый файл, а затем извлечь из него файлы с помощью следующей команды:

  dotnetfx35.exe /x extract-location

  После извлечения файлов появится структура файлов и папок со списком файлов, входящих в каждый из компонентов .NET Framework 3.5, как показано в приложении к настоящему документу.

  Для развертывания .NET Framework 3.5 включите соответствующие компоненты структуры папок, которая создается при извлечении, и добавьте их в загрузчик .NET Framework с помощью следующей команды:

  dotnetfx35setup.exe /q /norestart

  В приложении к этому документу можно найти два примера включения отдельных компонентов.

Независимо от выбранного варианта для включения .NET Framework 3.5 в процесс установки приложения необходимо запустить распространяемый пакет из командной строки, используя параметры /q и /norestart.

Примечание.
Чтобы языковой пакет не загружался и не устанавливался автоматически, используйте параметр командной строки /lang:enu.

Установка .NET Framework 3.5 для веб-приложений

Если веб-приложения используют функции .NET Framework 3.5, может потребоваться загрузка и установка .NET Framework на компьютер пользователя. Чтобы определить, установлена ли на пользовательском компьютере платформа .NET Framework 3.5, выполните действия, приведенные в следующем разделе. Если нужная версия .NET Framework не установлена, перенаправьте пользователей в Центр загрузки Майкрософт для загрузки пакета .NET Framework 3.5.

Обнаружение .NET Framework 3.5

Чтобы определить, установлена ли на компьютере платформа .NET Framework 3.5, можно проверить раздел реестра или запросить строку агента пользователя в Internet Explorer.

Чтение разделов реестра

При успешной установке .NET Framework 3.5 в реестр добавляются определенные разделы. Чтобы проверить, установлена ли на компьютере платформа .NET Framework 3.5, проверьте разделы реестра, указанные в следующей таблице.

Чтение строки агента пользователя в браузере

Если на компьютере установлена платформа .NET Framework 3.5, номер версии .NET Framework 3.5 указывается в строке агента пользователя, входящей в заголовки браузера. Ниже показан пример страницы, где с помощью JavaScript проверяется, установлена ли на компьютере платформа .NET Framework 3.5.

<html>
  <head>
    <title>Test for .NET Framework 3.5</title>
    <meta HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8" />
    <script type="text/JavaScript">
    <!--
    var NETFX3RuntimeVersion = "3.5.21022";
    
    function body_onload()
    {
      var result = document.getElementById("result");
      if (HasRuntimeVersion(NETFX3RuntimeVersion))
      {
          result.innerHTML = "This machine has the correct version of the .NET Framework 3.5 runtime: " 
          + NETFX3RuntimeVersion + "." 
          + "\n\nThis machine's userAgent string is: " 
          + navigator.userAgent + ".";
      } 
      else
      {
        result.innerHTML = "The .NET Framework version 3.5 is not installed on this computer.<br/>"
            + "Click <a href='https://go.microsoft.com/fwlink/?LinkId=96339'"
            + " here</a> to get the .NET Framework 3.5 now.";}
    }
    
    //
    // Retrieve the version from the user agent string and compare with specified version.
    //
    function HasRuntimeVersion(versionToCheck)
    {
      var userAgentString = 
           navigator.userAgent.match(/.NET CLR 3.5.[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 onload="body_onload();">
    <div id="result" ></div>
  </body>
</html>

Если поиск версии строки ".NET Framework 3.5" завершен успешно, появляется следующее сообщение.

This machine has the correct version of the .NET Framework 3.5 runtime: 3.5.28015.00.
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.5.28015.00).

(Точное содержание строки агента пользователя может быть различным в зависимости от названия и версии браузера, с помощью которого выполняется проверка наличия .NET Framework.)

Если платформа .NET Framework 3.5 не установлена, появляется следующее сообщение.

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

Параметры командной строки

В приведенной ниже таблице перечислены параметры, которые можно указывать при запуске установщика .NET Framework 3.5 из командной строки.

Коды ошибок

В следующей таблице перечислены коды ошибок, которые могут возвращаться программой установки распространяемого пакета .NET Framework 3.5. Коды ошибок аналогичны для всех версий установщика.

Приложение

В таблицах этого приложения используются следующие сокращения для операционных систем.

• XP = Windows XP

• Vista = Windows Vista

• W2K3 = Windows Server 2003

• W2K8 = Windows Server 2008

Компоненты .NET Framework 3.5

В приведенной ниже таблице перечислены компоненты .NET Framework 3.5.

Примеры установки

В примерах приведены списки файлов, которые необходимо разместить на носителе с программой установки, для двух различных сценариев.

Примечание.
При включении отдельных компонентов необходимо помещать их по тому же относительному пути, по которому они расположены в загрузчике программы установки .NET Framework 3.5 (dotNetFx35setup.exe).

Пример 1

В следующей таблице перечислены файлы, которые необходимо поместить на носитель с программой установки, чтобы развертывать приложение в Windows XP и Windows Vista. Предполагается, что пользователи устанавливают только версию x86, и что они уже установили пакет обновления 1 (SP1) для .NET Framework 2.0 и 3.0 (Windows XP и Windows Server 2003) или накопительное обновление (Windows Vista).

Пример 2

В следующей таблице перечислены файлы, которые необходимо поместить на носитель с программой установки, чтобы развертывать приложение на компьютера x86 и x64 под управлением Windows XP с пакетом обновления 2 (SP2) или Windows Server 2003 с пакетом обновления 1 (SP1). Предполагается, что пользователи уже установили .NET Framework версии 2.0 с пакетом обновления 1 (SP1).

Примечание.
Если пользователь не установил .NET Framework 2.0 с пакетом обновления 1 (SP1), то при наличии подключения к Интернету программа установки загрузит соответствующие компоненты автоматически.

См. также

Основные сведения

Руководство по развертыванию .NET Framework 3.5 для администраторов