App-Offlinedatei (app_offline.htm
)
Hinweis
Dies ist nicht die neueste Version dieses Artikels. Die aktuelle Version finden Sie in der .NET 9-Version dieses Artikels.
Warnung
Diese Version von ASP.NET Core wird nicht mehr unterstützt. Weitere Informationen finden Sie in der .NET- und .NET Core-Supportrichtlinie. Die aktuelle Version finden Sie in der .NET 9-Version dieses Artikels.
Wichtig
Diese Informationen beziehen sich auf ein Vorabversionsprodukt, das vor der kommerziellen Freigabe möglicherweise noch wesentlichen Änderungen unterliegt. Microsoft gibt keine Garantie, weder ausdrücklich noch impliziert, hinsichtlich der hier bereitgestellten Informationen.
Die aktuelle Version finden Sie in der .NET 9-Version dieses Artikels.
Die App-Offlinedatei (app_offline.htm
) wird vom ASP.NET Core-Modul verwendet, um eine App herunterzufahren.
Wenn eine Datei mit dem Namen app_offline.htm
im Stammverzeichnis einer App erkannt wird, versucht das ASP.NET Core-Modul, die App ordnungsgemäß zu beenden und die Verarbeitung eingehender Anforderungen zu stoppen. Wenn die App nach der Anzahl von Sekunden, die in shutdownTimeLimit
definiert wurde, noch ausgeführt wird, beendet das ASP.NET Core-Modul den laufenden Prozess.
Wenn die Datei app_offline.htm
vorhanden ist, reagiert das ASP.NET Core-Modul auf Anforderungen, indem es den Inhalt der app_offline.htm
-Datei zurücksendet. Die Größe von app_offline.htm
muss unter 4 GB liegen. Wenn die Datei app_offline.htm
entfernt wurde, wird die App von der nächsten Anforderung gestartet.
Beim Verwenden des Out-of-Process-Hostingmodells wird die App möglicherweise nicht sofort heruntergefahren, wenn eine offene Verbindung besteht. Beispielsweise kann eine WebSocket-Verbindung eine Verzögerung beim Herunterfahren der App bewirken.
Gesperrte Bereitstellungsdateien
Die Dateien im Bereitstellungsordner werden gesperrt, wenn die App ausgeführt wird. Gesperrte Dateien können während der Bereitstellung nicht überschrieben werden.
app_offline.htm
ist die primäre Methode, mit der gesperrte Dateien entsperrt werden. app_offline.htm
wird von Web Deploy verwendet, um die App ordnungsgemäß anzuhalten und zu starten.
app_offline.htm
kann manuell verwendet werden, um die App zu starten und anzuhalten (PowerShell 5 oder höher erforderlich):
$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
Für das vorangehende PowerShell-Skript gilt Folgendes:
- Der Platzhalter
{PATH TO APP}
ist der Pfad zur App. - Der
New-Item
-Befehl hält den App-Pool an. - Der
Remove-Item
-Befehl startet den App-Pool. - Befehle zwischen dem
New-Item
-Befehl und demRemove-Item
-Befehl werden vom Entwickler bereitgestellt, um die App bereitzustellen.
Dateien können auch entsperrt werden, indem der App-Pool vom IIS-Manager auf dem Server manuell angehalten wird. Verwenden Sie die app_offline.htm
-Datei nicht, wenn der IIS-Manager verwendet wird, um den App-Pool anzuhalten und neu zu starten.