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

  • Makale

Not

Bu, bu makalenin en son sürümü değildir. Geçerli sürüm için bu makalenin .NET 8 sürümüne bakın.

Uyarı

ASP.NET Core'un bu sürümü artık desteklenmiyor. Daha fazla bilgi için bkz . .NET ve .NET Core Destek İlkesi. Geçerli sürüm için bu makalenin .NET 8 sürümüne bakın.

Önemli

Bu bilgiler, ticari olarak piyasaya sürülmeden önce önemli ölçüde değiştirilebilen bir yayın öncesi ürünle ilgilidir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Geçerli sürüm için bu makalenin .NET 8 sürümüne bakın.

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.

Önkoş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 hizmetini 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ıyla localhostkullanı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.

Visual Studio'da geliştirme zamanı IIS desteğini etkinleştirme

  1. Visual Studio yükleyicisini başlatın.

  2. IIS geliştirme zamanı desteği için kullanmayı planladığınız Visual Studio yüklemesi için Değiştir'i seçin.

  3. ASP.NET ve web geliştirme iş yükü için Geliştirme zamanı IIS destek bileşenini bulun ve yükleyin.

    Bileşen, iş yüklerinin sağındaki Yükleme ayrıntıları panelinde geliştirme zamanı IIS desteği altında İsteğe bağlı bölümünde listelenir. Bileşen, ASP.NET Core uygulamalarını IIS ile çalıştırmak için gereken yerel bir IIS modülü olan ASP.NET Core Modülünü yükler.

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ğeri Developmentolan bir ortam değişkeni sağlayın.

  6. Web Sunucusu Ayarları alanında, Uygulama URL'sini Tarayıcı uç noktası URL'sini başlat 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 launchSettings.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.

Not

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

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.

Önkoş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 hizmetini 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ıyla localhostkullanı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 sonrası için bir bağlamanın varlığını onaylayın veya yeni bir site için 80 numaralı bağlantı noktasına 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.

Visual Studio'da geliştirme zamanı IIS desteğini etkinleştirme

  1. Visual Studio yükleyicisini başlatın.

  2. IIS geliştirme zamanı desteği için kullanmayı planladığınız Visual Studio yüklemesi için Değiştir'i seçin.

  3. ASP.NET ve web geliştirme iş yükü için Geliştirme zamanı IIS destek bileşenini bulun ve yükleyin.

    Bileşen, iş yüklerinin sağındaki Yükleme ayrıntıları panelinde geliştirme zamanı IIS desteği altında İsteğe bağlı bölümünde listelenir. Bileşen, ASP.NET Core uygulamalarını IIS ile çalıştırmak için gereken yerel bir IIS modülü olan ASP.NET Core Modülünü yükler.

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ğeri Developmentolan bir ortam değişkeni sağlayın.

  6. Web Sunucusu Ayarları alanında, Uygulama URL'sini Tarayıcı uç noktası URL'sini başlat 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 mevcut değilse, uygulamanın varsayılan barındırma modeli kullanılır ve işlem dışıdır. 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 launchSettings.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.

Not

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