ServiceBase.CanStop Propriedade

Definição

Namespace:

System.ServiceProcess

Assembly:

System.ServiceProcess.ServiceController.dll

Pacote:

System.ServiceProcess.ServiceController v9.0.0-preview.3.24172.9

Origem:

ServiceBase.cs

Obtém ou define um valor que indica se o serviço pode ser interrompido depois de ser iniciado.

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

public bool CanStop { get; set; }

member this.CanStop : bool with get, set

Public Property CanStop As Boolean

Valor da propriedade

Boolean

true se o serviço puder ser interrompido e o método OnStop() chamado, caso contrário, false.

Exceções

InvalidOperationException

O serviço já foi iniciado. A propriedade CanStop não pode ser alterada depois que o serviço é iniciado.

Comentários

Quando Stop é chamado em um serviço, o SCM (Service Control Manager) verifica se o serviço aceita comandos Stop usando o valor de CanStop. Para a maioria dos serviços, o valor de CanStop é true, mas alguns serviços do sistema operacional, por exemplo, não permitem que o usuário os interrompa.

Se CanStop for true, o comando Stop será passado para o serviço e o OnStop método será chamado se for definido. Se OnStop não for implementado na classe derivada, o SCM manipulará o comando Stop por meio do método de classe ServiceBase.OnStop base vazio.

Confira também

• OnStop()
• CanPauseAndContinue
• CanShutdown
• CanHandlePowerEvent