ServiceController.Start Method

Definition

Starts the service.

Overloads

Start()

Starts the service, passing no arguments.

Start(String[])

Starts a service, passing the specified arguments.

Start()

Source:
ServiceController.cs
Source:
ServiceController.cs
Source:
ServiceController.cs

Starts the service, passing no arguments.

C#
public void Start();

Exceptions

An error occurred when accessing a system API.

The service was not found.

Examples

The following example uses the ServiceController class to check whether the Alerter service is stopped. If the service is stopped, the example starts the service and waits until the service status is set to Running.

C#

// Check whether the Alerter service is started.

ServiceController sc  = new ServiceController();
sc.ServiceName = "Alerter";
Console.WriteLine("The Alerter service status is currently set to {0}",
                   sc.Status);

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

   Console.WriteLine("Starting the Alerter service...");
   try
   {
      // Start the service, and wait until its status is "Running".
      sc.Start();
      sc.WaitForStatus(ServiceControllerStatus.Running);

      // Display the current service status.
      Console.WriteLine("The Alerter service status is now set to {0}.",
                         sc.Status);
   }
   catch (InvalidOperationException)
   {
      Console.WriteLine("Could not start the Alerter service.");
   }
}

Remarks

You cannot call Stop for the service until the service controller status is Running.

See also

Applies to

.NET 10 (package-provided) and other versions
Product Versions
.NET Core 1.0, Core 1.1, 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

Start(String[])

Source:
ServiceController.cs
Source:
ServiceController.cs
Source:
ServiceController.cs

Starts a service, passing the specified arguments.

C#
public void Start(string[] args);

Parameters

args
String[]

An array of arguments to pass to the service when it starts.

Exceptions

An error occurred when accessing a system API.

The service cannot be started.

args is null.

-or-

A member of the array is null.

Remarks

You cannot call Stop for the service until the service controller status is Running.

See also

Applies to

.NET 10 (package-provided) and other versions
Product Versions
.NET Core 1.0, Core 1.1, 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)