ASP.NET Core için Visual Studio'da geliştirme zamanı IIS desteği

Sourabh Shirhatti tarafından

Bu makalede, Windows Server'da IIS ile çalışan ASP.NET Core uygulamalarında hata ayıklamaya yönelik Visual Studio desteği açıklanmaktadır. Bu konu başlığı altında, bu senaryoya olanak sağlama ve bir proje ayarlama adımları gösterilir.

Ön koşullar

• Windows için Visual Studio
• ASP.NET ve web geliştirme iş yükü
• .NET Core platformlar arası geliştirme iş yükü
• X.509 güvenlik sertifikası (HTTPS desteği için)

IIS'yi etkinleştirme

1. Windows'da Denetim Masası> Programs>Programlar ve Özellikler>Windows özelliklerini açma veya kapatma (ekranın sol tarafı) bölümüne gidin.
2. Internet Information Services onay kutusunu seçin. Tamam'ı seçin.

IIS yüklemesi, sistemin yeniden başlatılmasını gerektirebilir.

IIS'yi yapılandırma

IIS'de aşağıdakilerle yapılandırılmış bir web sitesi olmalıdır:

• Ana bilgisayar adı: Genellikle, Varsayılan Web Sitesi ana bilgisayar adıylalocalhostkullanılır. Ancak, benzersiz bir ana bilgisayar adına sahip tüm geçerli IIS web siteleri çalışır.
• Site Bağlama
  • HTTPS gerektiren uygulamalar için, sertifikayla 443 numaralı bağlantı noktasına bağlama oluşturun. Genellikle IIS Express Geliştirme Sertifikası kullanılır, ancak geçerli sertifikalar çalışır.
  • HTTP kullanan uygulamalar için 80 numaralı bağlantı noktasına bağlamanın varlığını onaylayın veya yeni bir site için bağlantı noktası 80'e bağlama oluşturun.
  • HTTP veya HTTPS için tek bir bağlama kullanın. Aynı anda hem HTTP hem de HTTPS bağlantı noktalarına bağlama desteklenmez.

Projeyi yapılandırma

HTTPS yeniden yönlendirme

HTTPS gerektiren yeni bir proje için, Yeni ASP.NET Çekirdek Web Uygulaması oluştur penceresinde HTTPS için yapılandır onay kutusunu seçin. Onay kutusunun seçilmesi, oluşturulduğunda uygulamaya HTTPS Yeniden Yönlendirme ve HSTS Ara Yazılımı ekler.

HTTPS gerektiren mevcut bir proje için, içinde HTTPS Yeniden Yönlendirme ve HSTS Ara Yazılımı kullanın Startup.Configure. Daha fazla bilgi için bkz . ASP.NET Core'da HTTPS'yi zorunlu kılma.

HTTP kullanan bir proje için, HTTPS Yeniden Yönlendirme ve HSTS Ara Yazılımı uygulamaya eklenmez. Uygulama yapılandırması gerekmez.

IIS başlatma profili

Geliştirme zamanı IIS desteği eklemek için yeni bir başlatma profili oluşturun:

1. Çözüm Gezgini'da projeye sağ tıklayın. Özellikleri'i seçin. Hata Ayıklama sekmesini açın.

2. Profil için Yeni düğmesini seçin. Açılan pencerede profili "IIS" olarak adlandırın. Profili oluşturmak için Tamam'ı seçin.

3. Başlat ayarı için listeden IIS'yi seçin.

4. Tarayıcıyı başlat onay kutusunu seçin ve uç nokta URL'sini sağlayın.

   Uygulama HTTPS gerektirdiğinde bir HTTPS uç noktası (https:// ) kullanın. HTTP için bir HTTP (http://) uç noktası kullanın.

   Daha önce belirtilen IIS yapılandırmasıyla aynı ana bilgisayar adını ve bağlantı noktasını sağlayın, genellikle localhost.

   URL'nin sonunda uygulamanın adını belirtin.

   Örneğin, https://localhost/WebApplication1 (HTTPS) veya http://localhost/WebApplication1 (HTTP) geçerli uç nokta URL'leridir.

5. Ortam değişkenleri bölümünde Ekle düğmesini seçin. AdıASPNETCORE_ENVIRONMENT ve DeğeriDevelopmentolan bir ortam değişkeni sağlayın.

6. Web Sunucusu Ayarlar alanında, Uygulama URL'sini Başlat tarayıcı uç noktası URL'si için kullanılan değere ayarlayın.

7. Visual Studio 2019 veya sonraki sürümlerde Barındırma Modeli ayarı için, proje tarafından kullanılan barındırma modelini kullanmak için Varsayılan'ı seçin. Proje, proje dosyasında özelliğini <AspNetCoreHostingModel> ayarlarsa, özelliğin (InProcess veya OutOfProcess) değeri kullanılır. Özellik yoksa, uygulamanın varsayılan barındırma modeli kullanılır ve bu işlem devam eder. Uygulama, uygulamanın normal barındırma modelinden farklı açık bir barındırma modeli ayarı gerektiriyorsa Barındırma Modeli'ni In Process gerektiği gibi veya Out Of Process olarak ayarlayın.

8. Profili kaydedin.

Visual Studio'yu kullanmadığınızda, Özellikler klasöründeki launch Ayarlar.json dosyasına el ile bir başlatma profili ekleyin. Aşağıdaki örnek, profili HTTPS protokolunu kullanacak şekilde yapılandırılır:

{
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iis": {
      "applicationUrl": "https://localhost/WebApplication1",
      "sslPort": 0
    }
  },
  "profiles": {
    "IIS": {
      "commandName": "IIS",
      "launchBrowser": true,
      "launchUrl": "https://localhost/WebApplication1",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

ve launchUrl uç noktalarının applicationUrl HTTP veya HTTPS gibi IIS bağlama yapılandırmasıyla aynı protokolü kullandığını onaylayın.

Projeyi çalıştırma

Visual Studio'yu yönetici olarak çalıştırın:

• Derleme yapılandırması açılan listesinin Hata Ayıklama olarak ayarlandığını onaylayın.
• Hata Ayıklamayı Başlat düğmesini IIS profiline ayarlayın ve uygulamayı başlatmak için düğmeyi seçin.

Yönetici olarak çalışmıyorsa Visual Studio yeniden başlatma isteğinde bulunabilir. İstenirse Visual Studio'yu yeniden başlatın.

Güvenilmeyen bir geliştirme sertifikası kullanılırsa, tarayıcı güvenilmeyen sertifika için bir özel durum oluşturmanızı gerektirebilir.

Dekont

Yalnızca Kodum ve derleyici iyileştirmeleri ile Yayın derleme yapılandırmasında hata ayıklamak, deneyimin düşmesine neden olur. Örneğin kesme noktalarına isabet edilmiyor.

Ek kaynaklar

• IIS'de IIS Yöneticisi ile Çalışmaya Başlama
• ASP.NET Core'da HTTPS'i zorunlu kılma