WindowsServiceLifetime Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Lauscht auf das Signal zum Herunterfahren und verfolgt den Status des Windows-Diensts.
public ref class WindowsServiceLifetime : System::ServiceProcess::ServiceBase, Microsoft::Extensions::Hosting::IHostLifetime
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public class WindowsServiceLifetime : System.ServiceProcess.ServiceBase, Microsoft.Extensions.Hosting.IHostLifetime
public class WindowsServiceLifetime : System.ServiceProcess.ServiceBase, Microsoft.Extensions.Hosting.IHostLifetime
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
type WindowsServiceLifetime = class
inherit ServiceBase
interface IHostLifetime
type WindowsServiceLifetime = class
inherit ServiceBase
interface IHostLifetime
Public Class WindowsServiceLifetime
Inherits ServiceBase
Implements IHostLifetime
- Vererbung
- Attribute
- Implementiert
Konstruktoren
| Name | Beschreibung |
|---|---|
| WindowsServiceLifetime(IHostEnvironment, IHostApplicationLifetime, ILoggerFactory, IOptions<HostOptions>, IOptions<WindowsServiceLifetimeOptions>) |
Initialisiert eine neue Instanz der WindowsServiceLifetime-Klasse. |
| WindowsServiceLifetime(IHostEnvironment, IHostApplicationLifetime, ILoggerFactory, IOptions<HostOptions>) |
Initialisiert eine neue Instanz von WindowsServiceLifetime. |
Felder
| Name | Beschreibung |
|---|---|
| MaxNameLength |
Gibt die maximale Größe für einen Dienstnamen an. (Geerbt von ServiceBase) |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AutoLog |
Gibt an, ob Befehle "Start", "Stopp", "Anhalten" und "Weiter" im Ereignisprotokoll angezeigt werden sollen. (Geerbt von ServiceBase) |
| CanHandlePowerEvent |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Dienst Benachrichtigungen über Computerleistungsstatusänderungen verarbeiten kann. (Geerbt von ServiceBase) |
| CanHandleSessionChangeEvent |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Dienst Sitzungsänderungsereignisse verarbeiten kann, die von einer Terminalserversitzung empfangen werden. (Geerbt von ServiceBase) |
| CanPauseAndContinue |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Dienst angehalten und fortgesetzt werden kann. (Geerbt von ServiceBase) |
| CanShutdown |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Dienst benachrichtigt werden soll, wenn das System heruntergefahren wird. (Geerbt von ServiceBase) |
| CanStop |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Dienst nach dem Starten beendet werden kann. (Geerbt von ServiceBase) |
| EventLog |
Ruft ein Ereignisprotokoll ab, mit dem Sie Benachrichtigungen über Dienstbefehlsaufrufe wie Start und Stop in das Anwendungsereignisprotokoll schreiben können. (Geerbt von ServiceBase) |
| ExitCode |
Dient zum Abrufen oder Festlegen des Exitcodes für den Dienst. (Geerbt von ServiceBase) |
| ServiceHandle |
Ruft das Dienststeuerungshandle für den Dienst ab. (Geerbt von ServiceBase) |
| ServiceName |
Ruft den kurzen Namen ab, der zum Identifizieren des Diensts für das System verwendet wird, oder legt diesen fest. (Geerbt von ServiceBase) |
Methoden
| Name | Beschreibung |
|---|---|
| Dispose(Boolean) |
Gibt die von der WindowsServiceLifetime. |
| OnContinue() |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ausgeführt, OnContinue() wenn ein Befehl "Weiter" vom Dienststeuerungs-Manager (Service Control Manager, SCM) an den Dienst gesendet wird. Gibt Aktionen an, die ausgeführt werden sollen, wenn ein Dienst nach der Pause wieder normal funktioniert. (Geerbt von ServiceBase) |
| OnCustomCommand(Int32) |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ausgeführt, OnCustomCommand(Int32) wenn der Dienststeuerungs-Manager (Service Control Manager, SCM) einen benutzerdefinierten Befehl an den Dienst übergibt. Gibt Aktionen an, die ausgeführt werden sollen, wenn ein Befehl mit dem angegebenen Parameterwert auftritt. (Geerbt von ServiceBase) |
| OnPause() |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ausgeführt, wenn ein Pause-Befehl vom Dienststeuerungs-Manager (Service Control Manager, SCM) an den Dienst gesendet wird. Gibt Aktionen an, die ausgeführt werden sollen, wenn ein Dienst angehalten wird. (Geerbt von ServiceBase) |
| OnPowerEvent(PowerBroadcastStatus) |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ausgeführt, wenn sich der Stromstatus des Computers geändert hat. Dies gilt für Laptopcomputer, wenn sie in den angehaltenen Modus wechseln, was nicht mit dem Herunterfahren des Systems übereinstimmt. (Geerbt von ServiceBase) |
| OnSessionChange(SessionChangeDescription) |
Wird ausgeführt, wenn ein Änderungsereignis von einer Terminalserversitzung empfangen wird. (Geerbt von ServiceBase) |
| OnShutdown() |
Wird ausgeführt, wenn ein Befehl zum Herunterfahren vom Dienststeuerungs-Manager (Service Control Manager, SCM) an den Dienst gesendet wird. |
| OnStart(String[]) |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ausgeführt, wenn ein Startbefehl vom Service Control Manager (SCM) an den Dienst gesendet wird oder wenn das Betriebssystem gestartet wird (für einen Dienst, der automatisch gestartet wird). Gibt Aktionen an, die ausgeführt werden sollen, wenn der Dienst gestartet wird. |
| OnStop() |
Wird ausgeführt, wenn ein Stop-Befehl vom Service Control Manager (SCM) an den Dienst gesendet wird. |
| RequestAdditionalTime(Int32) |
Fordert zusätzliche Zeit für einen ausstehenden Vorgang an. (Geerbt von ServiceBase) |
| RequestAdditionalTime(TimeSpan) |
Wenn diese Methode von OnStart, OnStop, OnPause oder OnContinue aufgerufen wird, wird der angegebene Wartehinweis an den Dienststeuerungs-Manager übergeben, um zu vermeiden, dass der Dienst als nicht reagiert. (Geerbt von ServiceBase) |
| ServiceMainCallback(Int32, IntPtr) |
Registriert den Befehlshandler und startet den Dienst. (Geerbt von ServiceBase) |
| Stop() |
Beendet den ausgeführten Dienst. (Geerbt von ServiceBase) |
| StopAsync(CancellationToken) |
Beendet und beendet den Host asynchron. Diese Methode wird von StopAsync(CancellationToken). |
| WaitForStartAsync(CancellationToken) |
Wartet asynchron, bis der Start abgeschlossen ist, bevor der Vorgang fortgesetzt wird. Diese Methode wird am Anfang von StartAsync(CancellationToken). Dies kann verwendet werden, um den Start zu verzögern, bis dieser durch ein externes Ereignis initiiert wird. |