Freigeben über


ServiceInstaller.ServiceName Eigenschaft

Definition

Gibt den Namen an, mit dem das System diesen Dienst identifiziert. Diese Eigenschaft muss mit dem ServiceName des zu installierenden Dienstes übereinstimmen.

public:
 property System::String ^ ServiceName { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ServiceName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ServiceProcess.ServiceProcessDescription("ServiceInstallerServiceName")]
public string ServiceName { get; set; }
[System.ServiceProcess.ServiceProcessDescription("ServiceInstallerServiceName")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ServiceName { get; set; }
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ServiceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
[<System.ServiceProcess.ServiceProcessDescription("ServiceInstallerServiceName")>]
member this.ServiceName : string with get, set
[<System.ServiceProcess.ServiceProcessDescription("ServiceInstallerServiceName")>]
[<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 zu installierenden Dienstes. Dieser Wert muss festgelegt werden, bevor das Installationsprogramm den Dienst installiert.

Attribute

Ausnahmen

Der Wert der ServiceName-Eigenschaft ist ungültig.

Hinweise

Es ist entscheidend, dass mit der der Klasse identisch ServiceName ServiceBase.ServiceName ist, die Sie von abgeleitet ServiceBase haben. Normalerweise wird der Wert der -Eigenschaft für den Dienst in der ServiceBase.ServiceName Main()-Funktion der ausführbaren Datei der Dienstanwendung festgelegt. Der Dienststeuerungs-Manager verwendet die ServiceInstaller.ServiceName -Eigenschaft, um den Dienst in dieser ausführbaren Datei zu suchen.

Wenn Sie die des Dienstinstallationsprogramms festlegen, wird der des zugeordneten Ereignisprotokolls ServiceName auf den gleichen Wert Source festgelegt. Dadurch kann der Dienst Automatisch Dienstbefehle (z. B. Starten und Beenden) Aufrufe des Anwendungsprotokolls auf dem Computer protokollieren.

Hinweis

Wenn eine Quelle mit demselben Namen bereits auf dem Computer vorhanden ist, aber in einem anderen Protokoll als dem Anwendungsprotokoll, wird eine Ausnahme ausgelöst. Wenn die Quelle vorhanden ist und dem Anwendungsprotokoll zugeordnet ist, wird diese Quelle verwendet, um Befehlsaufrufe an den Dienst zu melden, und es wird keine Ausnahme ausgelöst.

Der ServiceName darf nicht null 0 (null) lang sein oder haben. Die maximale Größe beträgt 256 Zeichen. Sie darf auch keine Schrägstriche, "/" oder "" oder Zeichen aus dem ASCII-Zeichensatz mit einem Wert kleiner als dem Dezimalwert \ 32 enthalten.

Gilt für

Siehe auch