Aracılığıyla paylaş

Uygulama Çevrimdışı dosyası (app_offline.htm)

  • Makale

Not

Bu, bu makalenin en son sürümü değildir. Geçerli sürüm için bu makalenin .NET 9 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 9 sürümüne bakın.

Uygulama Çevrimdışı dosyası (app_offline.htm), ASP.NET Core Modülü tarafından bir uygulamayı kapatmak için kullanılır.

Uygulamanın kök dizininde adı app_offline.htm olan bir dosya algılanırsa, ASP.NET Çekirdek Modülü uygulamayı düzgün bir şekilde kapatmayı ve gelen istekleri işlemeyi durdurmayı dener. uygulama içinde tanımlanan shutdownTimeLimitsaniye sayısından sonra çalışmaya devam ediyorsa, ASP.NET Çekirdek Modülü çalışan işlemi durdurur.

app_offline.htm Dosya mevcutken, ASP.NET Çekirdek Modülü dosyanın içeriğini app_offline.htm geri göndererek isteklere yanıt verir. değeri app_offline.htm 4 GB'tan az olmalıdır. app_offline.htm Dosya kaldırıldığında, sonraki istek uygulamayı başlatır.

İşlem dışı barındırma modeli kullanılırken, açık bir bağlantı varsa uygulama hemen kapatılamayabilir. Örneğin, bir WebSocket bağlantısı uygulamanın kapatılmasını geciktirebilir.

Kilitli dağıtım dosyaları

Uygulama çalıştırılırken dağıtım klasöründeki dosyalar kilitlenir. Dağıtım sırasında kilitli dosyaların üzerine yazılamaz.

app_offline.htm kilitli dosyaları serbest bırakmak için birincil mekanizmadır. app_offline.htm , Web Dağıtımı tarafından uygulamayı düzgün bir şekilde durdurmak ve başlatmak için kullanılır.

app_offline.htm uygulamayı başlatmak ve durdurmak için el ile kullanılabilir (PowerShell 5 veya üzeri gerektirir):

$pathToApp = '{PATH TO APP}'


New-Item -Path $pathToApp -Name "app_offline.htm" -ItemType "file"

# Provide script commands here to deploy the app

Remove-Item -Path $pathToApp\app_offline.htm

Önceki PowerShell betiğinde:

  • Yer tutucu {PATH TO APP} , uygulamanın yoludur.
  • Komut, New-Item uygulama havuzunu durdurur.
  • komutu Remove-Item uygulama havuzunu başlatır.
  • Komut ve Remove-Item komut arasındaki New-Item komutlar geliştirici tarafından uygulamayı dağıtmak için sağlanır.

Dosyaların kilidi, sunucudaki IIS Yöneticisi'ndeki uygulama havuzu el ile durdurularak da açılabilir. Uygulama havuzunu durdurmak ve yeniden başlatmak için IIS Yöneticisi'ni kullanırken dosyayı kullanmayın app_offline.htm .