ServiceInstaller.ServiceName Eigenschaft

Referenz

Definition

Namespace:: System.ServiceProcess

Assembly:: System.ServiceProcess.dll

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.

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: TypeConverterAttribute ServiceProcessDescriptionAttribute

Ausnahmen

ArgumentException

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