Windows'a .NET yükleme

• Windows
• MacOS’ta yükleme
• Linux'a yükle

Bu makalede, Windows hangi .NET sürümlerinin desteklendiği, .NET nasıl yükleneceği ve SDK ile çalışma zamanı arasındaki farklar hakkında bilgi verilmektedir.

.NET Framework'ün aksine, .NET Windows sürümünüzle bağlantılı değildir. Windows üzerinde yalnızca tek bir .NET Framework sürümü yüklü olabilir. Ancak .NET tek başınadır ve bilgisayarınızda herhangi bir yere yüklenebilir. Bazı uygulamalar kendi .NET kopyasını içerebilir.

Varsayılan olarak, yükleme yöntemi farklı bir dizin seçmediği sürece .NET bilgisayarınızdaki Program Files\dotnet dizinine yüklenir.

Önemli

Sistem genelinde .NET yüklüyorsanız, yönetim ayrıcalıklarıyla yükleyin.

.NET çalışma zamanı ve SDK'lardan oluşur. Çalışma zamanı .NET uygulamalar çalıştırır ve SDK, uygulama oluşturmak için kullanılır.

Doğru çalışma zamanını seçme

Windows için farklı uygulama türlerinin çalıştırılmasını sağlayan üç farklı çalışma zamanı vardır. SDK üç çalışma zamanını da içerir ve çalışma zamanı yükleyicisi ek çalışma zamanı içerebilir. Aşağıdaki tabloda belirli bir .NET yükleyicisine hangi çalışma zamanının dahil olduğu açıklanmaktadır:

Yükleyici	.NET Çalışma Zamanını içerir	.NET Masaüstü Çalışma Zamanı'nı içerir	ASP.NET Core Runtime'ı içerir
.NET Runtime	Evet	Hayır	Hayır
.NET Desktop Runtime	Evet	Evet	Hayır
ASP.NET Core Runtime	Hayır	Hayır	Evet
.NET SDK	Evet	Evet	Evet

tüm .NET uygulamaları Windows'de çalıştırabildiğinizi güvence altına almak için hem ASP.NET Core Çalışma Zamanı'nı hem de .NET Masaüstü Çalışma Zamanı'nı yükleyin. ASP.NET Core Çalışma Zamanı web tabanlı uygulamalar, .NET Masaüstü Çalışma Zamanı ise Windows Presentation Foundation (WPF) veya Windows Forms uygulaması gibi masaüstü uygulamalarını çalıştırır.

.NET nasıl yükleneceğini seçme

.NET yüklemenin farklı yolları vardır ve bazı ürünler kendi .NET sürümünü yönetebilir. .NET kendi .NET sürümünü yöneten yazılım aracılığıyla yüklerseniz, sistem genelinde etkinleştirilmemiş olabilir. .NET diğer yazılımlar aracılığıyla yüklemenin etkilerini anladığınızdan emin olun.

Aşağıdaki bölümlerde yer alan listeleri gözden geçirdikten sonra hangi yöntemi seçmeniz gerektiğine emin değilseniz, büyük olasılıkla .NET Installer kullanmak istersiniz.

Geliştiriciler

• Visual Studio

  Visual Studio kullanarak .NET uygulama geliştirmek istediğinizde .NET yüklemek için Visual Studio kullanın. Visual Studio kendi .NET kopyasını yönetir. Bu yöntem SDK, Çalışma Zamanı ve Visual Studio şablonlarını yükler.

• Visual Studio Code - C# Geliştirme Seti

  .NET uygulamaları geliştirmek için Visual Studio Code için C# Dev Kit uzantısını yükleyin. Uzantı, sizin için zaten yüklü bir SDK kullanabilir veya bir SDK yükleyebilir.

Kullanıcılar ve geliştiriciler

• .NET Yükleyici

  çalıştırdığınız yürütülebilir bir Windows Installer paketiyle .NET yükleyin. Bu yöntem SDK ve Çalışma Zamanı'nı yükleyebilir. Yüklemeler sistem genelinde gerçekleştirilir.

• Windows Package Manager (WinGet)

  komut satırı aracılığıyla .NET yönetmek istediğinizde .NET yüklemek için WinGet kullanın. Bu yöntem SDK ve Çalışma Zamanı'nı yükleyebilir. Yüklemeler sistem genelinde gerçekleştirilir.

• PowerShell

  SDK veya Çalışma Zamanı yüklemesini otomatikleştirebilen bir PowerShell betiği. Hangi .NET sürümünün yükleneceğini seçebilirsiniz.

Desteklenen sürümler

Aşağıdaki tablo, şu anda desteklenen .NET sürümlerinin ve desteklendiği Windows sürümlerinin listesidir. Bu sürümler, .NET sürümü destek sonu veya Windows sürümü kullanım süresi sonuna ulaşana kadar desteklenir.

İpucu

Bu tablo modern .NET (.NET Framework'ün aksine) için geçerlidir. .NET Framework'ü yüklemek için bkz. .NET Framework yükleme kılavuzu.

Windows 10 sürüm hizmet sonu tarihleri sürüme göre segmentlere ayrılmıştır. Aşağıdaki tabloda yalnızca Home, Pro, Pro Education ve Pro for Workstations sürümleri dikkate alınır. Belirli ayrıntılar için Windows yaşam döngüsü bilgi sayfasına bakın.

İşletim Sistemi	.NET 10 (Mimariler)	.NET 9 (Mimariler)	.NET 8 (Mimariler)
Windows 11 (24H2, 23H2, 22H2 Ent/Edu)	✔️ x64, Arm64	✔️ x64, Arm64	✔️ x64, Arm64
Windows 10 (22H2)	✔️ x64, Arm64	✔️ x64, Arm64	✔️ x64, Arm64
Windows Server 2025 Windows Server 2022 Windows Server 2019 Windows Server, Sürüm 1903 veya üzeri Windows Server 2016 Windows Server 2012 R2 Windows Server 2012	✔️ x64, x86	✔️ x64, x86	✔️ x64, x86
Windows Server Core 2012 (ve R2)	✔️ x64, x86	✔️ x64, x86	✔️ x64, x86
Nano Sunucu (2025, 2022, 2019)	✔️ x64	✔️ x64	✔️ x64
Windows 8.1	❌	❌	❌
Windows 7 SP1 ESU	❌	❌	❌

İpucu

Simge + , en düşük sürümü temsil eder.

Windows 7 / 8.1 / Server 2012

artık Windows 7 ve Windows 8.1 üzerinde desteklenen bir .NET sürümü yoktur. Desteklenen son sürümler .NET 6'ydı ve destek 12 Kasım 2024'te sona erdi.

Windows Server 2012 hala destekte olan tüm .NET sürümleri tarafından desteklenmektedir.

bu Windows sürümlerinin üçünün de yüklenmesi için daha fazla bağımlılık gerekir:

İşletim Sistemi	Önkoşullar
SP1 ESU Windows 7	- Microsoft Visual C++ 2015-2019 Yeniden Dağıtılabilir 64 bit / 32 bit - KB3063858 64 bit / 32 bit - Microsoft Kök Sertifika Yetkilisi 2011 (yalnızca .NET Core 2.1 çevrimdışı yükleyicisi)
Windows 8.1	Microsoft Visual C++ 2015-2019 Yeniden Dağıtılabilir 64 bit / 32 bit
Windows Server 2012	Microsoft Visual C++ 2015-2019 Yeniden Dağıtılabilir 64 bit / 32 bit
Windows Server 2012 R2	Microsoft Visual C++ 2015-2019 Yeniden Dağıtılabilir 64 bit / 32 bit

Aşağıdaki dll'lerden biriyle ilgili bir hata alırsanız önceki gereksinimler de gereklidir:

• api-ms-win-crt-runtime-l1-1-0.dll
• api-ms-win-cor-timezone-l1-1-0.dll
• hostfxr.dll

Arm tabanlı Windows bilgisayarlar

.NET Arm tabanlı Windows bilgisayarlarda desteklenir. Aşağıdaki bölümlerde, .NET yüklerken dikkate almanız gerekenler açıklanmaktadır.

Yol farklılıkları

Arm tabanlı Windows bilgisayarda, .NET tüm Arm64 sürümleri normal C:\Program Files\dotnet\ klasörüne yüklenir. Ancak, .NET SDK'sının x64 sürümü C:\Program Files\dotnet\x64\ klasörüne yüklenir.

Yol değişkenleri

.NET SDK'sının hem x64 hem de Arm64 sürümleri yüklüyse, PATH değişkeni gibi sistem yoluna .NET ekleyen ortam değişkenlerinin değiştirilmesi gerekebilir. Ayrıca bazı araçlar DOTNET_ROOT ortam değişkenini de kullanarak uygun .NET SDK yükleme klasörüne işaret edecek şekilde güncelleştirilecektir.

Visual Studio ile yükleme

Visual Studio, .NET diğer kopyalarından ayrı olarak kendi .NET kopyasını yükler. farklı Visual Studio sürümleri .NET'nin farklı sürümlerini destekler. Visual Studio'ın en son sürümü her zaman .NET'nin en son sürümünü destekler.

İndir Visual Studio Yükleyici

Visual Studio Yükleyicisi Visual Studio yükler ve yapılandırılır. ASP.NET ve web geliştirme ve .NET Çok platformlu Uygulama Kullanıcı Arabirimi geliştirme gibi bazı Visual Studio iş yükleri .NET içerir. .NET belirli sürümleri Individual Components sekmesi aracılığıyla yüklenebilir.

Visual Studio belgelerinde aşağıdakilerin nasıl yapılacağını gösteren yönergeler sağlanır:

• Visual Studio yükleyin.
• Visual Studio iş yüklerini yapılandırın.

.NET sürümleri ve Visual Studio

.NET uygulama geliştirmek için Visual Studio kullanıyorsanız, aşağıdaki tabloda hedef .NET SDK sürümüne göre gereken en düşük Visual Studio sürümü açıklanmaktadır.

.NET SDK sürümü	Visual Studio sürümü
10	Visual Studio 2026 sürüm 18.0 veya üzeri.
9	Visual Studio 2022 sürüm 17.12 veya üzeri.
8	Visual Studio 2022 sürüm 17.8 veya üzeri.
7	Visual Studio 2022 sürüm 17.4 veya üzeri.
6	Visual Studio 2022 sürüm 17.0 veya üzeri.
5	Visual Studio 2019 sürüm 16.8 veya üzeri.
3.1	Visual Studio 2019 sürüm 16.4 veya üzeri.
3.0	Visual Studio 2019 sürüm 16.3 veya üzeri.
2.2	Visual Studio 2017 sürüm 15.9 veya üzeri.
2.1	Visual Studio 2017 sürüm 15.7 veya üzeri.

Zaten Visual Studio yüklediyseniz, aşağıdaki adımlarla sürümünüzü de kontrol edebilirsiniz.

1. Visual Studio açın.
2. Yardım>Microsoft Visual Studio Hakkında'yı seçin.
3. Hakkında iletişim kutusunda sürüm numarasını okuyun.

Hakkında daha fazla bilgi için bkz. .NET SDK, MSBuild ve Visual Studio sürüm oluşturma.

Visual Studio Code ile yükleme

Visual Studio Code, masaüstünüzde çalışan güçlü ve basit bir kaynak kodu düzenleyicisidir. Visual Studio Code sisteminizde zaten yüklü olan SDK'yi kullanabilirsiniz.

Önemli

Sistem genelinde .NET yüklüyorsanız, yönetim ayrıcalıklarıyla yükleyin.

Bu WinGet yapılandırma dosyası en son .NET SDK'sını Visual Studio Code ve C# DevKit'i yükler. Bunlardan herhangi biri zaten yüklüyse, WinGet bu adımı atlar.

1. Dosyayı indirin ve çift tıklayarak çalıştırın.
2. Lisans sözleşmesini okuyun, yyazın ve kabul etmek isteyip istemediğiniz sorulduğunda Enter seçin.
3. Görev Çubuğunuzda yanıp sönen bir Kullanıcı Hesabı Denetimi (UAC) istemi alırsanız yüklemenin devam etmesi için izin verin.

Ayrıca C# Dev Kit uzantısı henüz yüklü değilse sizin için .NET yükler.

Visual Studio Code aracılığıyla .NET yükleme yönergeleri için bkz. VS Code'da C# ile Çalışmaya Başlama.

.NET yükleyicisi

.NET için indirme sayfası, Windows Yükleyici yürütülebilir dosyalarını sağlar.

Önemli

Sistem genelinde .NET yüklüyorsanız, yönetim ayrıcalıklarıyla yükleyin.

1. Bir web tarayıcısı açın ve https://dotnethttps://dotnet.microsoft.com/download/dotnetadresine gidin.

2. İndirmek istediğiniz .NET sürümünü (10.0 gibi) seçin.

3. .NET indirme bağlantılarını içeren SDK veya Çalışma Zamanı kutusunu bulun.

4. Installers sütununun altında Windows satırını bulun ve CPU mimarinizin bağlantısını seçin. Emin değilseniz en yaygın olan x64'i seçin.

   Tarayıcı yükleyiciyi otomatik olarak indirmelidir.

   İpucu

   Aşağıdaki görüntüde SDK gösterilmektedir, ancak Çalışma Zamanı'nı da indirebilirsiniz.

   

5. Windows Gezgini'ni açın ve büyük olasılıkla Downloads klasörünüzde dosyanın indirildiği yere gidin.

6. .NET yüklemek için dosyaya çift tıklayın.

   Windows Yükleyicisi iletişim kutusu açılır.

   

7. Yükle öğesini seçin ve .NET yüklemek için yönergeleri izleyin.

.NET CLI'yı kullanmayı öğrenmek için bkz. .NET CLI'ya genel bakış.

Komut satırı seçenekleri

Seçeneklerin /? listesini görüntülemek için parametresini kullanın.

.NET bir üretim ortamında olduğu gibi sessizce yüklemek veya sürekli tümleştirmeyi desteklemek istiyorsanız aşağıdaki seçenekleri kullanın:

• /install
  .NET yükler.

• /quiet
  Tüm kullanıcı arabirimi ve istemlerin görüntülenmesini engeller.

• /norestart
  Yeniden başlatma girişimlerini bastırır.

dotnet-sdk-9.0.100-win-x64.exe /install /quiet /norestart

.NET zaten yüklediyseniz, yüklemeyi yönetmek için .NET Yükleyicisi'ni kullanın. /installyerine aşağıdaki seçeneklerden birini kullanın:

• /uninstall
  bu .NET sürümünü kaldırın.

• /repair
  Yükleme anahtar dosyalarının veya bileşenlerinin zarar görmüş olup olmadığını denetleyin ve geri yükleyin.

İpucu

Yükleyici, başarı için 0 çıkış kodunu ve yeniden başlatma gerektiğini belirtmek için 3010 çıkış kodunu döndürür. Diğer tüm değerler büyük olasılıkla bir hata kodudur.

Microsoft Update

.NET yükleyici yürütülebilir dosyaları, Windows üzerinde Microsoft Update (MU) kullanılarak hizmet edilebilen bağımsız ürünlerdir. MU, .NET Framework gibi işletim sistemi bileşenlerine hizmet vermek için kullanılan Windows Update (WU) ile farklıdır.

Desteklenen .NET sürümleri için hem güvenlik hem de güvenlikle ilgili olmayan düzeltmeler, mu üzerinden birden çok dağıtım kanalı kullanılarak sağlanır. Otomatik Güncelleştirmeler (AU) son kullanıcılar ve tüketiciler için, Window Server Update Services (WSUS) ve Windows Update Kataloğu ise BT yöneticileriyle ilgilidir.

.NET yükleyici yürütülebilir dosyaları, çalışma zamanı ve SDK gibi farklı mimariler ve bileşenler için ana ve ikincil sürümlerde yan yana (SxS) yüklemeleri destekler. Örneğin, hem 6.0.15 (x64) hem de 6.0.17 (x86) çalışma zamanını yükleyebilirsiniz. MU tetiklendiğinde, her iki yükleme için de en son yükleyiciyi sunar.

Güncelleştirmeleri engelle

Kullanıcıların çoğu güncel tutulmasını tercih etse de, aşağıdaki tabloda yer alan kayıt defteri anahtarlarını kullanarak .NET güncelleştirmeleri engellemek mümkündür.

.NET sürümü	Kayıt defteri anahtarı	Adı	Tür	Değer
Tümü	HKLM\SOFTWARE\Microsoft\.NET	BlockMU	REG_DWORD	0x00000001
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	BlockMU	REG_DWORD	0x00000001
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	BlockMU	REG_DWORD	0x00000001
.NET 7	HKLM\SOFTWARE\Microsoft\.NET\7.0	BlockMU	REG_DWORD	0x00000001
.NET 6	HKLM\SOFTWARE\Microsoft\.NET\6.0	BlockMU	REG_DWORD	0x00000001
.NET 5	HKLM\SOFTWARE\Microsoft\.NET\5.0	BlockMU	REG_DWORD	0x00000001
.NET Core 3.1	HKLM\SOFTWARE\Microsoft\.NET\3.1	BlockMU	REG_DWORD	0x00000001
.NET Core 2.1	HKLM\SOFTWARE\Microsoft\.NET\2.1	BlockMU	REG_DWORD	0x00000001

Sunucu işletim sistemi için otomatik güncelleştirmeler

Sunucu işletim sistemleri güncelleştirmeleri WSUS ve Microsoft Update Kataloğu tarafından desteklenir, ancak AU tarafından desteklenmez. Sunucu işletim sistemleri, aşağıdaki kayıt defteri anahtarlarını kullanarak AU aracılığıyla güncelleştirmeleri almayı kabul edebilir.

.NET sürümü	Kayıt defteri anahtarı	Adı	Tür	Değer
Tümü	HKLM\SOFTWARE\Microsoft\.NET	Sunucu İşletim Sisteminde Otomatik Güncellemeye İzin Ver	REG_DWORD	0x00000001
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	Sunucu İşletim Sisteminde Otomatik Güncellemeye İzin Ver	REG_DWORD	0x00000001
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	Sunucu İşletim Sisteminde Otomatik Güncellemeye İzin Ver	REG_DWORD	0x00000001
.NET 7	HKLM\SOFTWARE\Microsoft\.NET\7.0	Sunucu İşletim Sisteminde Otomatik Güncellemeye İzin Ver	REG_DWORD	0x00000001
.NET 6	HKLM\SOFTWARE\Microsoft\.NET\6.0	Sunucu İşletim Sisteminde Otomatik Güncellemeye İzin Ver	REG_DWORD	0x00000001
.NET 5	HKLM\SOFTWARE\Microsoft\.NET\5.0	Sunucu İşletim Sisteminde Otomatik Güncellemeye İzin Ver	REG_DWORD	0x00000001
.NET Core 3.1	HKLM\SOFTWARE\Microsoft\.NET\3.1	Sunucu İşletim Sisteminde Otomatik Güncellemeye İzin Ver	REG_DWORD	0x00000001

WSUS ve güncelleştirme sınıflandırmaları

WSUS, sınıflandırmasına göre belirli güncelleştirmeler sağlayacak şekilde yapılandırılabilir. .NET güncelleştirmeleri güvenlik veya critical olarak sınıflandırılır. En son güncelleştirme kritik olarak sınıflandırılırsa, en son güvenlik güncelleştirmesinin yerini alan eski bir .NET sürümü yüklendiğinde eski bir güvenlik güncelleştirmesi sunulabilir. Bu, bir makineyi taramak için çevrimdışı CAB (Wsusscan2.cab) kullanmak için de geçerlidir.

Not

Bazı durumlarda WSUS, yüklediğiniz .NET sürümünden daha eski bir sürüm için eksik bir güncelleştirme bildirebilir. Örneğin, bir kullanıcının .NET 6'nın en son sürümü olan .NET 6.0.36'yı yüklemiş olduğunu düşünün. Bu sürüm kritik (güvenlikle ilgili olmayan) bir güncelleştirme olarak sınıflandırılır. Ardından bir uygulama eski bir sürüm olan 6.0.33'ü yükler. (Uygulamaların önkoşul olarak belirli .NET sürümlerini içermesi sık karşılaşılan bir durum değildir.) Bir yönetici WSUS'yi yalnızca güvenlik güncelleştirmelerini sağlayacak şekilde yapılandırdıysa, sonraki taramada 6.0.35 eksik bir güncelleştirme olarak bildirilecektir. Güvenlik güncelleştirmelerini AU veya WSUS aracılığıyla alacak şekilde yapılandırılmış makineler, 6.0.36 yüklü olsa bile 6.0.35 sunulacaktır. Bunun nedeni, 6.0.35'in 6.0.33'in yerini alıp en son güvenlik güncelleştirmesi olmasıdır.

Önceki sürümlerin ne zaman kaldırıldığını seçme

Yükleyici yürütülebilir dosyaları, önceki yüklemeyi kaldırmadan önce her zaman yeni içerik yükler. Eski çalışma zamanları kaldırıldığında çalışan uygulamalar kesintiye uğrayabilir veya kilitlenebilir. .NET güncelleştirmenin etkisini en aza indirmek için, bir kayıt defteri anahtarı kullanılarak önceki bir .NET yüklemesinin ne zaman kaldırılacağını belirtebilirsiniz.

.NET sürümü	Kayıt defteri anahtarı	Adı	Tür	Değer
Tümü	HKLM\SOFTWARE\Microsoft\.NET	Önceki Sürümü Kaldır	REG_SZ	always, never veya nextSession
.NET 10	HKLM\SOFTWARE\Microsoft\.NET\10.0	Önceki Sürümü Kaldır	REG_SZ	always, never veya nextSession
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	Önceki Sürümü Kaldır	REG_SZ	always, never veya nextSession
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	Önceki Sürümü Kaldır	REG_SZ	always, never veya nextSession

• never önceki yüklemeleri korur ve önceki .NET yüklemelerini kaldırmak için el ile müdahale gerektirir.
• always yeni sürüm yüklendikten sonra önceki yüklemeleri kaldırır. Bu, .NET'daki varsayılan davranıştır.
• nextSession , Yöneticiler grubundaki üyelerin bir sonraki oturum açma oturumuna kadar kaldırmayı engeller.
• Değerler büyük/küçük harfe duyarlı değildir ve geçersiz değerler varsayılan olarak always değerine ayarlanır.

Kaldırma işlemi ertelendiğinde, yükleyici önceki sürümü kaldırmak için RunOnce kayıt defteri anahtarına bir komut yazar. Komut yalnızca Yöneticiler grubundaki bir kullanıcı makinede oturum açtığında yürütülür.

Not

Bu özellik yalnızca .NET 8 (8.0.11) ile başlayarak kullanılabilir. Yalnızca tek başına yükleyici yürütülebilir dosyaları için geçerlidir ve bunları kullanan WinGet gibi dağıtımları etkiler.

Windows Package Manager ile yükleme (WinGet)

winget.exe aracını kullanarak Windows Package Manager hizmeti aracılığıyla .NET yükleyebilir ve yönetebilirsiniz. WinGet'i yükleme ve kullanma hakkında daha fazla bilgi için bkz. Uygulamaları yüklemek ve yönetmek için winget aracını kullanma.

Önemli

Sistem genelinde .NET yüklüyorsanız, yönetim ayrıcalıklarıyla yükleyin.

.NET WinGet paketleri şunlardır:

• Microsoft.DotNet.Runtime.10—.NET Çalışma Zamanı 10.0
• Microsoft.DotNet.AspNetCore.10—ASP.NET Core Çalışma Zamanı 10.0
• Microsoft.DotNet.DesktopRuntime.10—.NET Desktop Runtime 10.0
• Microsoft.DotNet.SDK.10—.NET SDK 10.0
• Microsoft.DotNet.Runtime.9—.NET Runtime 9.0
• Microsoft.DotNet.AspNetCore.9—ASP.NET Core Runtime 9.0
• Microsoft.DotNet.DesktopRuntime.9—.NET Desktop Runtime 9.0
• Microsoft.DotNet.SDK.9—.NET SDK 9.0
• Microsoft.DotNet.Runtime.8—.NET Runtime 8.0
• Microsoft.DotNet.AspNetCore.8—ASP.NET Core Çalışma Zamanı 8.0
• Microsoft.DotNet.DesktopRuntime.8—.NET Desktop Runtime 8.0
• Microsoft.DotNet.SDK.8—.NET SDK 8.0

SDK’yı yükleyin

SDK'yı yüklerseniz ilgili çalışma zamanını yüklemeniz gerekmez.

1. WinGet'i yükleyin.

2. PowerShell veya Komut İstemi gibi bir terminal açın.

3. winget install komutunu çalıştırın ve SDK paketinin adını geçirin:

   winget install Microsoft.DotNet.SDK.10
   

.NET CLI'yı kullanmayı öğrenmek için bkz. .NET CLI'ya genel bakış.

Çalışma zamanını yükle

Yükleyebileceğiniz farklı çalışma zamanları vardır. Her çalışma zamanına nelerin dahil olduğunu anlamak için Doğru çalışma zamanını seçme bölümüne bakın.

1. WinGet'i yükleyin.

2. PowerShell veya Komut İstemi gibi bir terminal açın.

3. winget install komutunu çalıştırın ve SDK paketinin adını geçirin:

   winget install Microsoft.DotNet.DesktopRuntime.10
   winget install Microsoft.DotNet.AspNetCore.10
   

.NET CLI'yı kullanmayı öğrenmek için bkz. .NET CLI'ya genel bakış.

Sürüm arama

Yüklemek istediğiniz paketin winget search farklı sürümlerini aramak için komutunu kullanın. Örneğin, aşağıdaki komut WinGet aracılığıyla kullanılabilen tüm .NET SDK'ları arar:

winget search Microsoft.DotNet.SDK

Arama sonuçları, her paket tanımlayıcısı olan bir tabloya yazdırılır.

Name                            Id                           Version                 Source
--------------------------------------------------------------------------------------------
Microsoft .NET SDK 3.1          Microsoft.DotNet.SDK.3_1     3.1.426                 winget
Microsoft .NET SDK 5.0          Microsoft.DotNet.SDK.5       5.0.408                 winget
Microsoft .NET SDK 6.0          Microsoft.DotNet.SDK.6       6.0.428                 winget
Microsoft .NET SDK 7.0          Microsoft.DotNet.SDK.7       7.0.410                 winget
Microsoft .NET SDK 8.0          Microsoft.DotNet.SDK.8       8.0.415                 winget
Microsoft .NET SDK 9.0          Microsoft.DotNet.SDK.9       9.0.306                 winget
Microsoft .NET SDK 10.0         Microsoft.DotNet.SDK.10      10.0.100                winget

Önizleme sürümlerini yükleme

Bir önizleme sürümü varsa, Kimlik'teki sürüm numarasını Preview sözcüğü ile değiştirin. Aşağıdaki örnek, .NET Desktop Runtime'ın önizleme sürümünü yükler:

winget install Microsoft.DotNet.DesktopRuntime.Preview

PowerShell ile yükleme

Sürekli tümleştirme ve yönetici olmayan yüklemeler için dotnet-install PowerShell betiği aracılığıyla .NET yüklenmesi önerilir. Sisteminizde normal kullanım için .NET yüklüyorsanız .NET Yükleyici veya Windows Package Manager yükleme yöntemlerini kullanın.

Betik varsayılan olarak en son uzun süreli destek (LTS) sürümünü, .NET 10'u yükler. -Channel anahtarını belirterek belirli bir sürümü seçebilirsiniz. -Runtime anahtarını ekleyerek bir çalışma zamanı yükleyin. Aksi takdirde betik SDK'yı yükler. Betik https://dot.net/v1/dotnet-install.ps1 adresinde bulunur ve kaynak kod GitHub üzerinde barındırılır.

Betiği indir

Betik hakkında daha fazla bilgi için dotnet-kurulum betiği referansına bkz..

Çalışma zamanını yükle

.NET Çalışma Zamanı, -Runtime seçeneği sağlanarak yüklenir.

1. Yükleme betiğini şu kaynaktan indirin: https://dot.net/v1/dotnet-install.ps1

2. PowerShell'i açın ve betiği içeren klasöre gidin.

3. En yüksek uyumluluk için hem Masaüstü çalışma zamanını hem de ASP.NET Core çalışma zamanını yüklemek için aşağıdaki komutları çalıştırın:

   dotnet-install.ps1 -Runtime windowsdesktop
   dotnet-install.ps1 -Runtime aspnetcore
   

.NET CLI'yı kullanmayı öğrenmek için bkz. .NET CLI'ya genel bakış.

SDK’yı yükleyin

SDK'yı yüklerseniz çalışma zamanlarını yüklemeniz gerekmez.

1. Yükleme betiğini şu kaynaktan indirin: https://dot.net/v1/dotnet-install.ps1

2. PowerShell'i açın ve betiği içeren klasöre gidin.

3. .NET SDK'sını yüklemek için aşağıdaki komutu çalıştırın.

   dotnet-install.ps1
   

   Not

   SDK, -Runtime anahtarını çıkararak yüklenir.

.NET CLI'yı kullanmayı öğrenmek için bkz. .NET CLI'ya genel bakış.

Doğrulama

Yükleyiciyi veya ikili sürümü indirdikten sonra dosyanın değiştirilmediğinden veya bozulmadığından emin olmak için dosyayı doğrulayın. Bilgisayarınızda kontrol toplamını doğrulayabilir ve ardından indirme web sitesinde bildirilenle karşılaştırabilirsiniz.

Dosya resmi bir indirme sayfasından indirildiğinde, dosyanın sağlama toplamı bir metin kutusunda görüntülenir. Sağlama toplamı değerini panonuza kopyalamak için Kopyala düğmesini seçin.

Özet kontrolü (checksum) içeren .NET indirme sayfası

İndirdiğiniz dosyanın sağlama toplamını doğrulamak için PowerShell veya Komut İstemi'ni kullanabilirsiniz. Örneğin, aşağıdaki komut dotnet-sdk-9.0.306-win-x64.exe dosyasının sağlama toplamını bildirir.

> certutil -hashfile dotnet-sdk-9.0.306-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-9.0.306-win-x64.exe:
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f
CertUtil: -hashfile command completed successfully.

> (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f

Kontrol toplamını indirme sitesi tarafından sağlanan değerle karşılaştırın.

Doğrulama için PowerShell ve sağlama toplamı dosyası kullanın.

.NET sürüm notları, indirilen dosyanızı doğrulamak için kullanabileceğiniz sağlama toplamı dosyasının bağlantısını içerir. Aşağıdaki adımlarda sağlama toplamı dosyasını indirip bir .NET kurulum ikilisine doğrulamak için izlenmesi gereken adımlar açıklanmaktadır:

1. https://github.com/dotnet/core/tree/main/release-notes/9.0 GitHub .NET 9 sürüm notları sayfasında Releases adlı bir bölüm bulunur. Bu bölümdeki tablo, her .NET 9 sürümü için indirme ve kontrol toplamı dosyalarına bağlantılar sağlar. Aşağıdaki görüntüde .NET 8 sürüm tablosu başvuru olarak gösterilmektedir:

   

2. İndirdiğiniz .NET sürümünün bağlantısını seçin. Önceki bölümde, .NET 9.0.10 sürümünde yer alan .NET SDK 9.0.306 kullanılmıştır.

   İpucu

   Checksum dosyanızın hangi .NET sürümünde olduğunu bilmiyorsanız, bulana kadar bağlantıları keşfedin.

3. Yayın sayfasında .NET Çalışma Zamanı ve .NET SDK sürümünü ve sağlama toplamı dosyasının bağlantısını görebilirsiniz. Aşağıdaki görüntüde .NET 8 sürüm tablosu başvuru olarak gösterilmektedir:

   

4. Sağlama toplamı dosyasının bağlantısını kopyalayın.

5. Aşağıdaki komut dosyasını kullanın, ancak uygun sağlama toplamı dosyasını indirmek için bağlantıyı değiştirin.

   Invoke-WebRequest https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt -OutFile 9.0.10-sha.txt
   

6. Sağlama toplamı dosyası ve .NET yayın dosyası aynı dizine indirilirken, .NET indirmenin sağlama toplamı için sağlama toplamı dosyasında arama yapın:

   Doğrulama başarılı olduğunda Doğru yazdırıldı ifadesini görürsünüz:

   > (Get-Content .\9.0.10-sha.txt | Select-String "dotnet-sdk-9.0.306-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash + "*"
   True
   

   False'un yazdırıldığını görürseniz, indirdiğiniz dosya geçerli değildir ve kullanılmamalıdır.

Sorun giderme

.NET SDK'sını yükledikten sonra, .NET CLI komutlarını çalıştırmaya çalışırken sorunlarla karşılaşabilirsiniz. Bu bölümde bu yaygın sorunlar toplanır ve çözümler sağlanır.

• .NET SDK bulunamadı
• Uygulama oluşturma işlemi beklenenden daha yavaş
• hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll eksik

.NET SDK bulunamadı

Büyük olasılıkla .NET SDK'sının hem x86 (32 bit) hem de x64 (64 bit) sürümlerini yüklemişsinizdir. Komutu çalıştırdığınızda x64 sürümüne çözümlenmesi gerekirken x86 sürümüne çözümlendiği için bu bir çakışmaya sebep oluyor. Bu sorun, değişkeni önce x64 sürümünü çözecek şekilde ayarlayarak %PATH% düzeltilir.

1. komutunu çalıştırarak where.exe dotnet her iki sürümün de yüklü olduğunu doğrulayın. Bunu yaparsanız, hem Program Files\ hem de Program Files (x86)\ klasörleri için bir girdi görmeniz gerekir. Aşağıdaki örnekte gösterildiği gibi Program Files (x86)\ klasörü ilk sıradaysa, bu yanlıştır ve sonraki adıma geçmeniz gerekir.

   > where.exe dotnet
   C:\Program Files (x86)\dotnet\dotnet.exe
   C:\Program Files\dotnet\dotnet.exe
   

   İpucu

   Bu örnekte Program Files kullanılmış olsa da, dotnet.exe diğer kopyalarını listelenmiş olarak görebilirsiniz. Bunları, önce uygun olan dotnet.exe'ün çözümlenmesini sağlamak için ayarlayın.

   Doğruysa ve Program Files\ önceyse, bu bölümde tartışılan sorunla karşı karşıya değilsiniz ve GitHub'da bir .NET yardım talebi oluşturmalısınız.

2. Windows düğmesine basın ve aramaya "Sistem ortamı değişkenlerini düzenle" yazın. Sistem ortamı değişkenlerini düzenle'yi seçin.

   

3. Sistem Özellikleri penceresi Gelişmiş Sekmesi'ne açılır. Ortam Değişkenleri'ne tıklayın.

   

4. Ortam Değişkenleri penceresinin Sistem değişkenleri grubunun altında Yol* satırını ve ardından Düzenle düğmesini seçin.

   

5. girdisini C:\ (x86)\Program Files\ dotnet ve Program Files düğmelerini kullanın.

   

Uygulama oluşturma işlemi beklenenden daha yavaş

Windows bir özellik olan Akıllı Uygulama Denetimi'nin kapalı olduğundan emin olun. Akıllı Uygulama Denetimi'nin geliştirme için kullanılan makinelerde etkinleştirilmesi önerilmez. "Kapalı" dışındaki tüm ayarlar SDK performansını olumsuz etkileyebilir.

hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll eksik

Microsoft Visual C++ 2015-2019 Yeniden Dağıtılabilir'i (64 bit veya 32 bit) yükleyin.

İlgili içerik

• .NET CLI'ya genel bakış
• Yeni bir .NET sürümüne yükseltin.
• .NET zaten yüklü olup olmadığını denetleme.
• Eğitim: Yeni bir konsol uygulaması oluşturma