ServiceController.Stop Метод

Определение

Пространство имен:

System.ServiceProcess

Сборка:

System.ServiceProcess.ServiceController.dll

Пакет:

System.ServiceProcess.ServiceController v11.0.0-preview.2.26159.112

Перегрузки

Имя	Описание
Stop()	Останавливает эту службу и все службы, зависящие от этой службы.
Stop(Boolean)	Останавливает службу и при необходимости любые службы, зависящие от этой службы.

Stop()

Исходный код:

ServiceController.cs

Останавливает эту службу и все службы, зависящие от этой службы.

public:
 void Stop();

public void Stop();

member this.Stop : unit -> unit

Public Sub Stop ()

Исключения

Win32Exception

Ошибка при доступе к системным API.

InvalidOperationException

Служба не найдена.

Примеры

В следующем примере класс используется ServiceController для проверки текущего состояния службы Telnet. Если служба остановлена, в примере запускается служба. Если служба запущена, пример останавливает службу.

// Toggle the Telnet service - 
// If it is started (running, paused, etc), stop the service.
// If it is stopped, start the service.
ServiceController^ sc = gcnew ServiceController(  "Telnet" );
if ( sc )
{
   Console::WriteLine(  "The Telnet service status is currently set to {0}", sc->Status );
   if ( (sc->Status == (ServiceControllerStatus::Stopped) ) || (sc->Status == (ServiceControllerStatus::StopPending) ) )
   {
      // Start the service if the current status is stopped.
      Console::WriteLine(  "Starting the Telnet service..." );
      sc->Start();
   }
   else
   {
      // Stop the service if its status is not set to "Stopped".
      Console::WriteLine(  "Stopping the Telnet service..." );
      sc->Stop();
   }

   // Refresh and display the current service status.
   sc->Refresh();
   Console::WriteLine(  "The Telnet service status is now set to {0}.", sc->Status );

// Toggle the Telnet service -
// If it is started (running, paused, etc), stop the service.
// If it is stopped, start the service.
ServiceController sc = new ServiceController("Telnet");
Console.WriteLine("The Telnet service status is currently set to {0}",
                  sc.Status);

if ((sc.Status == ServiceControllerStatus.Stopped) ||
    (sc.Status == ServiceControllerStatus.StopPending))
{
   // Start the service if the current status is stopped.

   Console.WriteLine("Starting the Telnet service...");
   sc.Start();
}
else
{
   // Stop the service if its status is not set to "Stopped".

   Console.WriteLine("Stopping the Telnet service...");
   sc.Stop();
}

// Refresh and display the current service status.
sc.Refresh();
Console.WriteLine("The Telnet service status is now set to {0}.",
                   sc.Status);

' Toggle the Telnet service - 
' If it is started (running, paused, etc), stop the service.
' If it is stopped, start the service.
Dim sc As New ServiceController("Telnet")
Console.WriteLine("The Telnet service status is currently set to {0}", sc.Status)

If sc.Status.Equals(ServiceControllerStatus.Stopped) Or sc.Status.Equals(ServiceControllerStatus.StopPending) Then
   ' Start the service if the current status is stopped.
   Console.WriteLine("Starting the Telnet service...")
   sc.Start()
Else
   ' Stop the service if its status is not set to "Stopped".
   Console.WriteLine("Stopping the Telnet service...")
   sc.Stop()
End If

' Refresh and display the current service status.
sc.Refresh()
Console.WriteLine("The Telnet service status is now set to {0}.", sc.Status)

Комментарии

Если какие-либо службы зависят от этой службы для их работы, они будут остановлены до остановки этой службы. Свойство DependentServices содержит набор служб, зависящих от этого.

Если остановить службу, от которой зависит эта служба, вызовите Stop метод в этой службе в Stop методе родительской службы. Свойство ServicesDependedOn содержит службы, от которые зависит эта служба.

См. также раздел

• CanStop
• Start()
• Status

Stop(Boolean)

Исходный код:

ServiceController.cs

Останавливает службу и при необходимости любые службы, зависящие от этой службы.

public:
 void Stop(bool stopDependentServices);

public void Stop(bool stopDependentServices);

member this.Stop : bool -> unit

Public Sub Stop (stopDependentServices As Boolean)

Параметры

stopDependentServices

Boolean

true для остановки всех работающих зависимых служб вместе со службой; false , чтобы остановить только службу.

Комментарии

Если какие-либо другие службы зависят от этого, перед вызовом этого метода необходимо передать truestopDependentServices или остановить их вручную.