ServiceBase.ServiceName Eigenschaft

Referenz

Definition

Namespace:: System.ServiceProcess

Assembly:: System.ServiceProcess.ServiceController.dll

Assembly:: System.ServiceProcess.dll

Paket:: System.ServiceProcess.ServiceController v8.0.1

Paket:: System.ServiceProcess.ServiceController v9.0.0-rc.2.24473.5

Quelle:: ServiceBase.cs

Quelle:: ServiceBase.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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:

Freigeben über