ServiceBase.CanStop-Eigenschaft

Artikel
08/20/2007

Ruft einen Wert ab, der angibt, ob der Dienst nach dem Starten beendet werden kann, oder legt diesen fest.

Namespace: System.ServiceProcess
Assembly: System.ServiceProcess (in system.serviceprocess.dll)

Syntax

'Declaration
Public Property CanStop As Boolean
'Usage
Dim instance As ServiceBase
Dim value As Boolean

value = instance.CanStop

instance.CanStop = value

public bool CanStop { get; set; }

public:
property bool CanStop {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_CanStop ()

/** @property */
public void set_CanStop (boolean value)

public function get CanStop () : boolean

public function set CanStop (value : boolean)

Eigenschaftenwert

true, wenn der Dienst angehalten und die OnStop-Methode aufgerufen werden kann, andernfalls false.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Der Dienst wurde bereits gestartet. Die CanStop-Eigenschaft kann nach dem Start des Diensts nicht mehr geändert werden.

Hinweise

Wenn für einen Dienst Beenden aufgerufen wird, überprüft der Dienststeuerungs-Manager anhand des Werts von CanStop, ob der Dienst Befehle zum Beenden zulässt. Für die meisten Dienste ist der Wert von CanStoptrue, einige Betriebssystemdienste lassen jedoch z. B. kein Beenden durch den Benutzer zu.

Wenn CanStoptrue ist, wird der Befehl zum Beenden an den Dienst übergeben und die OnStop-Methode aufgerufen, sofern diese definiert ist. Wenn OnStop nicht in einer abgeleiteten Klasse implementiert ist, verarbeitet der Dienststeuerungs-Manager den Befehl zum Beenden über die ServiceBase.OnStop-Methode der leeren Basisklasse.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ServiceBase-Klasse
ServiceBase-Member
System.ServiceProcess-Namespace
OnStop
ServiceBase.CanPauseAndContinue-Eigenschaft
ServiceBase.CanShutdown-Eigenschaft
ServiceBase.CanHandlePowerEvent-Eigenschaft

Freigeben über