ServiceBase.ServiceName ServiceBase.ServiceName ServiceBase.ServiceName ServiceBase.ServiceName Property

Definition

Ruft den zur Bezeichnung des Diensts beim System verwendeten kurzen Namen ab oder legt diesen fest.Gets or sets the short name used to identify the service to the system.

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

Eigenschaftswert

Der Name des Dienstes.The name of the service.

Ausnahmen

Der Dienst wurde bereits gestartet.The service has already been started. Die ServiceName-Eigenschaft kann nach dem Start des Diensts nicht mehr geändert werden.The ServiceName property cannot be changed once the service has started.

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.The specified name is a zero-length string or is longer than MaxNameLength, or the specified name contains forward slash or backslash characters.

Hinweise

Der ServiceName identifiziert den Dienst für den Dienststeuerungs-Manager.The ServiceName identifies the service to the Service Control Manager. Der Wert dieser Eigenschaft muss mit dem Namen identisch sein, der in der ServiceInstaller.ServiceName -Eigenschaft der entsprechenden Installer-Klasse für den Dienst aufgezeichnet wurde.The value of this property must be identical to the name recorded for the service in the ServiceInstaller.ServiceName property of the corresponding installer class. Im Code wird der ServiceName des dienstanin der Regel in der main() Funktion der ausführbaren Datei festgelegt.In code, the ServiceName of the service is usually set in the main() function of the executable.

Der ServiceName wird auch verwendet, um den EventLog.Source der EventLog Eigenschaft zugeordneten anzugeben.The ServiceName is also used to specify the EventLog.Source associated with the EventLog property. Dabei EventLog handelt es sich um eine-Instanz, die Dienst Befehls Informationen in das Anwendungsprotokoll schreibt.This EventLog is an instance that writes service command information to the Application log.

Der ServiceName, der die Quell Zeichenfolge für das Ereignisprotokoll bereitstellt, muss festgelegt werden, bevor der Dienst in das Ereignisprotokoll schreibt.The ServiceName, which supplies the source string for the event log, must be set before the service writes to the event log. Wenn Sie versuchen, auf das Ereignisprotokoll zuzugreifen, bevor der Quellname festgelegt wurde, wird eine Ausnahme ausgelöst.Trying to access the event log before the source name is set causes an exception to be thrown.

Gilt für:

Siehe auch