ServiceController.ServiceName-Eigenschaft

Ruft den Namen ab, der den Dienst identifiziert, auf den diese Instanz verweist, oder richtet diesen Namen ein.

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

Syntax

'Declaration
Public Property ServiceName As String
'Usage
Dim instance As ServiceController
Dim value As String

value = instance.ServiceName

instance.ServiceName = value

public string ServiceName { get; set; }

public:
property String^ ServiceName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_ServiceName ()

/** @property */
public void set_ServiceName (String value)

public function get ServiceName () : String

public function set ServiceName (value : String)

Eigenschaftenwert

Der Name, der den Dienst identifiziert, auf den diese ServiceController-Instanz verweist. Der Standardwert ist eine leere Zeichenfolge ("").

Ausnahmen

Hinweise

ServiceName bezeichnet den Dienst für den Dienststeuerungs-Manager. Durch das Ändern dieser Eigenschaft wird die ServiceController-Instanz an einen anderen Dienst gebunden. Die Anzeige im Dienststeuerungs-Manager-Snap-In der Microsoft Management Console ändert sich dadurch nicht.

Wenn Sie einen benutzerdefinierten Dienst implementieren, muss der Wert dieser Eigenschaft mit dem Namen übereinstimmen, der für den Dienst in der ServiceName-Eigenschaft der entsprechenden ServiceInstaller-Klasse erfasst wurde. Im Code wird ServiceName i. d. R. in der main()-Funktion der ausführbaren Datei festgelegt.

Wenn Sie die ServiceName-Eigenschaft zurücksetzen, wird DisplayName für diese Instanz von der Methode, die diese Eigenschaft festlegt, auf eine leere Zeichenfolge ("") festgelegt.

Beispiel

Im folgenden Beispiel wird mithilfe der ServiceController-Klasse überprüft, ob der Warndienst beendet wurde. Im Beispiel wird der Dienst gestartet, sofern er beendet wurde, und es wird gewartet, bis der Dienststatus auf Running festgelegt ist.

' Check whether the Alerter service is started.

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

If sc.Status = ServiceControllerStatus.Stopped Then
   ' 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 
      Console.WriteLine("Could not start the Alerter service.")
   End Try
End If

// 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.ToString());

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.ToString());
   }
   catch (InvalidOperationException)
   {
      Console.WriteLine("Could not start the Alerter service.");
   }
}

// Check whether the Alerter service is started.
ServiceController^ sc = gcnew ServiceController;
if ( sc )
{
   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^ e ) 
      {
         Console::WriteLine(  "Could not start the Alerter service." );
      }
   }
}

// Check whether the Alerter service is started.
ServiceController sc = new ServiceController();
sc.set_ServiceName("Alerter");
Console.WriteLine("The Alerter service status is currently set to {0}",
    sc.get_Status().ToString());

if (sc.get_Status().Equals(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.get_Status().ToString());
    }
    catch (InvalidOperationException exp) {
        Console.WriteLine("Could not start the Alerter service.");
    }
}

.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

ServiceController-Klasse
ServiceController-Member
System.ServiceProcess-Namespace