Microsoft .NET Framework 3.0 Dağıtım Kılavuzu

Makale
05/11/2010

Microsoft Corporation

Temmuz 2006

İçindekiler

Özet
Giriş
Yükleme Gereksinimleri
   Yazılım Gereksinimleri
   Donanım Gereksinimleri
.NET Framework 3.0 Yeniden Dağıtılabilir Paketi Nereden Alınır?
Visual Studio 2005 Kurulum Projesi Kullanarak .NET Framework 3.0'a Yeniden Dağıtma
Kullanıcıların .NET Framework El ile Yüklemesini Yapma
Uygulama Kurulumunuzda Yeniden Dağıtılabilir Paketi Zincirleme
Web Uygulamaları için .NET Framework 3.0'da Yeniden Dağıtma
Microsoft .NET Framework 3.0'u algılama
   Kayıt Defteri Anahtarlarını Okuma
   Internet Explorer'da Kullanıcı Aracısı Dizesini Okuma
.NET Framework 3.0 Yeniden Dağıtılabilir için Komut Satırı Seçenekleri
.NET Framework 3.0 Yeniden Dağıtılabilir için Hata Kodları

Özet

Bu makalede, .NET Framework 3.0 yeniden dağıtılabilir paketi olan Dotnetfx3.exe ile Microsoft .NET Framework 3.0 uygulamalarının nasıl dağıtılacağı açıklanır. (10 yazdırılan sayfa)

Not Bu belgeler, dağıtımı tartışan senaryolara yönelik bilgiler içerebilir, ancak belgeler size Bileşenlerin herhangi bir bölümünü kullanma veya dağıtma hakkı vermez. Bileşenleri kullanımınız, Bileşenler için lisans sözleşmesine tabidir. Haklarınızı ve kullanım koşullarınızı anlamak için lütfen Bileşenler lisans sözleşmesini gözden geçirin.

Giriş

Microsoft.NET Framework 3.0, .NET Framework 3.0 uygulamalarını çalıştırmak için gerekli Windows Vista API'lerine .NET Framework 2.0 bağlamaları içeren yeniden dağıtılabilir bir yükleyici sağlar.

.NET Framework 3.0 yeniden dağıtılabilir paketi tek başına yürütülebilir dosya olarak kullanılabilir. Dosyanın adı hedeflenen platformun türüne bağlıdır. 32 bit platformlar için dosya Dotnetfx3.exe olarak adlandırılır. 64 bit platformlar için dosya Dotnetfx3_x64.exe olarak adlandırılır. Kurulum sırasında gerekli bileşenleri indiren Dotnet3setup.exe adlı küçük bir yeniden dağıtılabilir paket de dağıtabilirsiniz.

Not .NET Framework 3.0'daki IA64 desteği Microsoft Windows Server kod adı "Longhorn" ile sınırlıdır. Longhorn zaten .NET Framework 3.0 içerir, bu nedenle yeniden dağıtılabilir paket gerekmez.

Yeniden dağıtılabilir bir bilgisayarı el ile başlatabilir ve yükleyebilirsiniz veya bir .NET Framework 3.0 uygulaması için kurulum programının bir parçası olarak başlatılabilir ve yüklenebilir.

Not .NET Framework 3.0'ı yüklemek için yönetici ayrıcalıkları gerekir.

Yükleme Gereksinimleri

Bu bölümde, Microsoft .NET Framework 3.0 yeniden dağıtılabilir paketinin yükleneceği bir bilgisayarın yazılım ve donanım gereksinimleri açıklanmaktadır. En düşük gereksinimler karşılanmazsa, Dotnetfx3.exe yeniden dağıtılabilir paketin yüklenmesini engeller.

Yazılım Gereksinimleri

Microsoft .NET Framework 3.0'ı yüklemek için aşağıdaki işletim sistemlerinden birinin hedef bilgisayara yüklenmesi gerekir:

Microsoft Windows XP Home veya Microsoft Windows XP Professional, hem Service Pack 2 hem de üzeri.
Service Pack 1 veya üzeri yüklü Microsoft Windows Server 2003 ailesi.

Microsoft Windows Vista (IA64 platformu dahil değildir) ve "Longhorn" IA64 Edition kod adlı Microsoft Windows Server için .NET Framework 3.0 işletim sisteminin bir özelliğidir.

Donanım Gereksinimleri

Aşağıdaki tabloda .NET Framework 3.0 çalıştırmaya yönelik donanım gereksinimleri listelemektedir.

	CPU gerekli	RAM gerekli
Minimum	Pentium 400 MHz	96 MB
Önerilen	Pentium 1 GHz veya üzeri	256 MB veya daha fazla

.NET Framework 3.0 Yeniden Dağıtılabilir Paketi Nereden Alınır?

Microsoft .NET Framework 3.0 yeniden dağıtılabilir paketini Microsoft Vista İndirme Merkezi'nden veya Microsoft Windows Update Web sitesinden indirebilirsiniz.

Not Microsoft Windows Update sitesi yalnızca resmi olarak yayınlanan .NET Framework 3.0 sürümünü sunar; beta sürümleri sunmaz.

Kullanıcıların Microsoft .NET Framework 3.0'ı İnternet'ten yüklemesini istiyorsanız, yeniden dağıtılabilir paketi kendi ağınıza göndermeyin. Bunun yerine, kullanıcıları Microsoft Vista İndirme Merkezi'ne veya Microsoft Windows Update Web sitesine yönlendirin.

Visual Studio 2005 Kurulum Projesi Kullanarak .NET Framework 3.0'a Yeniden Dağıtma

Visual Studio 2005 ile oluşturulan ve .NET Framework 3.0 gerektiren uygulamaları dağıttığınızda, uygulamanız yüklenmeden önce .NET Framework hedef bilgisayara yüklenmelidir. .NET Framework 3.0'i Visual Studio 2005 kurulum projesi kullanarak oluşturduğunuz bir kurulum yürütülebilir dosyasına ekleyebilirsiniz. Bu pratik değilse, daha sonra açıklandığı gibi kullanıcıların .NET Framework el ile yüklemesini sağlayabilirsiniz.

Microsoft .NET Framework 3.0'ı uygulamanızla birlikte yüklemek için bir Visual Studio 2005 kurulum projesi yapılandırdığınızda, .NET Framework 3.0 uygulamanızla birlikte paketlenmiş durumdadır. Uygulamanızın kurulumundaki bir başlatma koşulu, whether.NET Framework 3.0'ın yüklü olduğunu denetler ve gerekirse, kurulum işlemi uygulamanızı yüklemeden önce .NET Framework yükler. Microsoft .NET Framework 3.0, whether.NET Framework 2.0'ın yüklendiğini denetler. Aksi takdirde, kurulum işlemi kullanıcıdan .NET Framework önceki sürümünü de yüklemesini ister.

Uygulamanızın kurulum işlemine .NET Framework 3.0 eklemek için, kurulum projesini oluşturduğunuz bilgisayara .NET Framework 3.0 için isteğe bağlı Visual Studio Uzantıları yüklenmelidir.

.NET Framework 3.0 için Visual Studio Uzantılarının yüklü olup olmadığını belirlemek için

Windows Denetim Masası Program Ekle veya Kaldır'a tıklayın.
Program Ekle veya Kaldır iletişim kutusunda, .NET Framework 3.0 için Microsoft Visual Studio 2005 Uzantıları içinŞu anda yüklü programlar listesini inceleyin.

.NET Framework 3.0 için Visual Studio 2005 Uzantıları listelenmiyorsa, Microsoft İndirme Merkezi'nin Microsoft Visual Studio Code Adı "Orcas" Topluluk Teknolojisi Önizlemesi – WinFX için Geliştirme Araçları sayfasında bulunan WinFX için Geliştirme Araçları'nın bir parçası olarak uzantı paketini indirip yükleyebilirsiniz.

Bilgisayarınızda .NET Framework 3.0 paketi için Visual Studio Uzantıları'nın yüklü olduğundan emin olduğunuzda, .NET Framework 3.0'ı içeren bir kurulum projesi oluşturabilirsiniz.

.NET Framework 3.0'ı bir kurulum projesine eklemek için

Visual Studio 2005'te aşağıdaki adımları izleyerek yeni bir kurulum projesi oluşturun:
1. Dosya menüsünde Yeni'ye ve ardından Proje'ye tıklayın.
2. Diğer Proje Türleri'nin altında Kurulum ve Dağıtım'ı seçin.
3. Projenizi adlandırıp Tamam'a tıklayın.
Proje çıkışınızı ekleyin, modülleri, dosyayı ve derlemeleri birleştirin.
Çözüm Gezgini'da proje adına sağ tıklayın ve ardından Özellikler'e tıklayın.

Özellik Sayfaları iletişim kutusu görüntülenir.
Önkoşullar'a tıklayın.
Önkoşul bileşenlerini yüklemek için kurulum programı oluştur onay kutusunu seçin.
Listede Microsoft .NET Framework 3.0'ı bulun ve hedef platformlar için uygun sürümü seçin.
Önkoşullar için kaynak konumu belirtin.

.NET Framework 3.0 konumu için Windows Vista İndirme sitesini veya kendi sitenizi belirtebilirsiniz. URL, kendi uygulamanızın dağıtıldığı bir CD de belirtebilir.
Tamam'a tıklayın.

Kullanıcıların .NET Framework El ile Yüklemesini Yapma

Bazı durumlarda, .NET Framework 3.0'ı uygulamanızla otomatik olarak yüklemeniz pratik olmayabilir. Bu durumda, kullanıcıların .NET Framework kendilerinin yüklemesini sağlayabilirsiniz. Yeniden dağıtılabilir, daha önce the.NET Framework 3.0 Yeniden Dağıtılabilir Paketi Edinme bölümünde belirtildiği gibi çeşitli kaynaklardan kullanılabilir. Ancak, uygulamanızın kullanıcılarının uygulamayı nereden edineceklerini veya nasıl yükleyebileceklerini bildiklerini varsaymamalısınız. Kurulum işleminizde, kullanıcıların .NET Framework nasıl bulup yüklemeleri gerektiğine ilişkin yönergeler sağlayın.

Uygulama Kurulumunuzda Yeniden Dağıtılabilir Paketi Zincirleme

Visual Studio kurulum projesi oluşturmak istemiyorsanız veya kullanıcıların .NET Framework 3.0'ı el ile yüklemesini istiyorsanız, .NET Framework 3.0 yükleme işlemini kendi uygulama kurulumunuzun bir parçası olarak zincirleyebilirsiniz. .NET Framework 3.0 yükleme işlemini zincire eklemek için yeniden dağıtılabilir öğesini komut satırından çalıştırabilir ve aşağıdaki sessiz yükleme komut satırı seçeneğini kullanabilirsiniz:

/q /norestart

Web Uygulamaları için .NET Framework 3.0'da Yeniden Dağıtma

.NET Framework 3.0 özelliklerini kullanan Web tabanlı uygulamalarda, .NET Framework kullanıcının bilgisayarına indirilip yüklenmesi gerekebilir. Tarayıcı üst bilgisindeki kullanıcı aracısı dizesini sorgulayarak kullanıcının bilgisayarında .NET Framework 3.0'ın yüklü olup olmadığını belirleyebilirsiniz. .NET Framework doğru sürümü yüklü değilse, .NET Framework 3.0 paketini almak için kullanıcıları .NET Framework 3.0 İndirme Merkezi'ne yönlendirebilirsiniz.

Microsoft .NET Framework 3.0'ın algılanması

.NET Framework 3.0'ın yüklü olup olmadığını bir kayıt defteri anahtarını okuyarak ve Internet Explorer'daki kullanıcı aracısı dizesini sorgulayarak algılayabilirsiniz.

Kayıt Defteri Anahtarlarını Okuma

.NET Framework 3.0 yükleyicisi, yükleme başarılı olduğunda kayıt defteri anahtarlarını yazar. Aşağıdaki tabloda listelenen kayıt defteri anahtarlarını denetleyerek whether.NET Framework 3.0'ın yüklendiğini test edebilirsiniz.

Kayıt Defteri Anahtarı Adı Değer

Kayıt Defteri Anahtarı Adı	Değer
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup`	Ad: `InstallSuccess` Tür: DWORD Veriler: `1`
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform`	Ad: `Version` Tür: REG_SZ Veriler: `.NET CLR 3.0.build number`

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

Ad: InstallSuccess

Tür: DWORD

Veriler: 1

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

Ad: Version

Tür: REG_SZ

Veriler: .NET CLR 3.0.build number

Internet Explorer'da Kullanıcı Aracısı Dizesini Okuma

.NET Framework 3.0 bir bilgisayara yüklendiğinde, .NET Framework 3.0 sürüm numarası tarayıcı üst bilgilerinde bildirilen kullanıcı aracısı dizesinin bir parçası olarak görünür. Aşağıdaki örnekte, whether.NET Framework 3.0'ın yüklendiğini algılamak ve raporlamak için JavaScript kullanan örnek bir sayfa gösterilmektedir.

Not Bu örnek sayfa Internet Explorer gerektirir.

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

".NET Framework 3.0" sürümü dizesini arama başarılı olursa, aşağıdaki ileti görüntülenir:

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

Aksi takdirde, aşağıdaki ileti görüntülenir:

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

.NET Framework 3.0 Yeniden Dağıtılabilir için Komut Satırı Seçenekleri

Aşağıdaki tabloda, komut satırından .NET Framework 3.0 yeniden dağıtılabilir yükleme programını (Dotnetfx3.exe, Dotnetfx3_x64.exe veya Dotnet3setup.exe) çalıştırdığınızda ekleyebileceğiniz seçenekler listelenmiştir.

Seçenek	Açıklama
`/q`	Tüm kullanıcı arabirimini gizler. Bu seçenekle bir .INI dosyası belirtilemez.
`/quiet`	ile `/q`aynı.
`/qb`	Yalnızca ilerleme durumunu gösteren en düşük kullanıcı arabirimini görüntüler.
`/passive`	ile `/qb`aynı.
`/uninstall`	Ürünü kaldırır.
`/remove`	ile `/uninstall`aynı.
`/f`	Yüklü tüm .NET Framework 3.0 bileşenlerini onarın.
`/nopatch`	Düzeltme eklerinin uygulanmadığını belirtir ve düzeltme eki denetimini atlar.
`/norollback`	Bir kurulum bileşeni başarısız olursa kurulumun geri alınmadığını belirtir.
`/norestart`	Yükleme tamamlandıktan sonra yükleyicinin bilgisayarı yeniden başlatmadığını belirtir. Yeniden dağıtılabilir yükleyici, yeniden başlatma gerekiyorsa ERROR_SUCCESS_REBOOT_REQUIRED (3010) döndürür.
`/?`	Bu seçenek listesini görüntüler.

.NET Framework 3.0 Yeniden Dağıtılabilir için Hata Kodları

Aşağıdaki tabloda, .NET Framework 3.0 yeniden dağıtılabilir yükleme programı (Dotnetfx3.exe, Dotnetfx3_x64.exe veya Dotnet3setup.exe) tarafından döndürülebilecek hata kodları listelenmektedir. Hata kodları yükleyicinin tüm sürümleri için aynıdır.

Hata Kodu	Değer	Açıklama
`ERROR_SUCCESS`	0	Eylem başarıyla tamamlandı.
`ERROR_INSTALL_USEREXIT`	1602	Kullanıcı yüklemeyi iptal etti.
`ERROR_INSTALL_FAILURE`	1603	Yükleme sırasında ciddi bir hata oluştu.
`ERROR_UNKNOWN_PRODUCT`	1605	Bu eylem yalnızca şu anda yüklü olan ürünler için geçerlidir.
`ERROR_PATCH_PACKAGE_INVALID`	1636	Düzeltme eki paketi açılamadı veya düzeltme eki .NET Framework 3.0 için geçerli değildi.
`ERROR_INVALID_COMMAND_LINE`	1639	Geçersiz komut satırı bağımsız değişkeni.
`ERROR_SUCCESS_REBOOT_INITIATED`	1641	Yükleyici yeniden başlatma başlattı. Bu, başarılı olduğunu gösterir ve kurulum yeniden başlatıldıktan sonra devam eder. (Seçenek belirtildiyse `/norestart` yeniden başlatma gerçekleştirilmiyor.)
`ERROR_PATCH_PACKAGE_REJECTED`	1643	Düzeltme eki paketine sistem ilkesi tarafından izin verilmez.
`ERROR_SUCCESS_REBOOT_REQUIRED`	3010	Yüklemenin tamamlanması için yeniden başlatma gereklidir. Bu ileti başarılı olduğunu gösterir.