ServiceBase.ServiceName Eigenschaft

  • Referenz

Definition

Namespace:
System.ServiceProcess
Assembly:
System.ServiceProcess.ServiceController.dll
Assembly:
System.ServiceProcess.dll
Paket:
System.ServiceProcess.ServiceController v6.0.0
Paket:
System.ServiceProcess.ServiceController v7.0.0
Paket:
System.ServiceProcess.ServiceController v8.0.0
Paket:
System.ServiceProcess.ServiceController v9.0.0-preview.2.24128.5
Source:
ServiceBase.cs
Source:
ServiceBase.cs
Source:
ServiceBase.cs

Ruft den zur Bezeichnung des Diensts beim System verwendeten kurzen Namen ab oder legt diesen fest.

public:
 property System::String ^ ServiceName { System::String ^ get(); void set(System::String ^ value); };
public string ServiceName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ServiceProcess.ServiceProcessDescription("SBServiceName")]
public string ServiceName { get; set; }
[System.ServiceProcess.ServiceProcessDescription("SBServiceName")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ServiceName { get; set; }
[System.ServiceProcess.ServiceProcessDescription("SBServiceName")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ServiceName { get; set; }
member this.ServiceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
[<System.ServiceProcess.ServiceProcessDescription("SBServiceName")>]
member this.ServiceName : string with get, set
[<System.ServiceProcess.ServiceProcessDescription("SBServiceName")>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ServiceName : string with get, set
[<System.ServiceProcess.ServiceProcessDescription("SBServiceName")>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ServiceName : string with get, set
Public Property ServiceName As String

Eigenschaftswert

String

Der Name des Diensts.

Attribute
TypeConverterAttribute ServiceProcessDescriptionAttribute

Ausnahmen

InvalidOperationException

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

ArgumentException

Der angegebene Name ist eine Zeichenfolge der Länge 0 (null) oder ist länger als MaxNameLength, oder der angegebene Name enthält Schrägstriche oder umgekehrte Schrägstriche.

Hinweise

Der ServiceName identifiziert den Dienst an den Dienststeuerungs-Manager. Der Wert dieser Eigenschaft muss mit dem Namen identisch sein, der für den Dienst in der ServiceInstaller.ServiceName -Eigenschaft der entsprechenden Installerklasse aufgezeichnet wird. Im Code wird der ServiceName des Diensts in der Regel in der main() Funktion der ausführbaren Datei festgelegt.

Wird ServiceName auch verwendet, um die EventLog.Source der -Eigenschaft zugeordnete EventLog anzugeben. Dies EventLog ist eine instance, die Dienstbefehlsinformationen in das Anwendungsprotokoll schreibt.

Die ServiceName, die die Quellzeichenfolge für das Ereignisprotokoll bereitstellt, muss festgelegt werden, bevor der Dienst in das Ereignisprotokoll schreibt. Wenn Sie versuchen, auf das Ereignisprotokoll zuzugreifen, bevor der Quellname festgelegt wird, wird eine Ausnahme ausgelöst.

Gilt für:

Weitere Informationen