Udostępnij za pośrednictwem

Plik trybu offline aplikacji (app_offline.htm)

  • Artykuł

Uwaga

Nie jest to najnowsza wersja tego artykułu. Aby zapoznać się z bieżącą wersją, zobacz wersję tego artykułu platformy .NET 9.

Ostrzeżenie

Ta wersja ASP.NET Core nie jest już obsługiwana. Aby uzyskać więcej informacji, zobacz zasady pomocy technicznej platformy .NET i platformy .NET Core. Aby zapoznać się z bieżącą wersją, zobacz wersję tego artykułu platformy .NET 9.

Ważne

Te informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany, zanim zostanie wydany komercyjnie. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Aby zapoznać się z bieżącą wersją, zobacz wersję tego artykułu platformy .NET 9.

Plik trybu offline aplikacji (app_offline.htm) jest używany przez moduł ASP.NET Core w celu zamknięcia aplikacji.

Jeśli plik o nazwie app_offline.htm zostanie wykryty w katalogu głównym aplikacji, moduł ASP.NET Core próbuje bezpiecznie zamknąć aplikację i zatrzymać przetwarzanie żądań przychodzących. Jeśli aplikacja jest nadal uruchomiona po liczbie sekund zdefiniowanych w programie shutdownTimeLimit, moduł ASP.NET Core zatrzymuje uruchomiony proces.

app_offline.htm Gdy plik jest obecny, moduł ASP.NET Core odpowiada na żądania, wysyłając z powrotem zawartość app_offline.htm pliku. Wartość app_offline.htm musi być mniejsza niż 4 GB. Po usunięciu app_offline.htm pliku następne żądanie uruchamia aplikację.

W przypadku korzystania z modelu hostingu poza procesem aplikacja może nie zostać natychmiast zamknięta, jeśli istnieje otwarte połączenie. Na przykład połączenie protokołu WebSocket może opóźnić zamknięcie aplikacji.

Zablokowane pliki wdrożenia

Pliki w folderze wdrożenia są zablokowane, gdy aplikacja jest uruchomiona. Zablokowanych plików nie można zastąpić podczas wdrażania.

app_offline.htm jest podstawowym mechanizmem zwalniania zablokowanych plików. app_offline.htm Jest używany przez narzędzie Web Deploy, aby prawidłowo zatrzymać i uruchomić aplikację.

app_offline.htm Można użyć ręcznie do uruchamiania i zatrzymywania aplikacji (wymaga programu PowerShell 5 lub nowszego):

$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

W poprzednim skry skryptzie programu PowerShell:

  • Symbol zastępczy {PATH TO APP} to ścieżka do aplikacji.
  • Polecenie New-Item zatrzymuje pulę aplikacji.
  • Polecenie Remove-Item uruchamia pulę aplikacji.
  • Polecenia między poleceniem New-Item a Remove-Item poleceniem są udostępniane przez dewelopera w celu wdrożenia aplikacji.

Pliki można również odblokować, ręcznie zatrzymując pulę aplikacji w Menedżerze usług IIS na serwerze. Nie używaj app_offline.htm pliku podczas korzystania z Menedżera usług IIS, aby zatrzymać i ponownie uruchomić pulę aplikacji.