ServiceInstaller.ServiceName-Eigenschaft

Artikel
08/20/2007

Gibt den vom System zum Identifizieren dieses Dienstes verwendeten Namen an. Diese Eigenschaft muss mit dem ServiceBase.ServiceName des zu installierenden Dienstes übereinstimmen.

Namespace: System.ServiceProcess
Assembly: System.ServiceProcess (in system.serviceprocess.dll)

Syntax

'Declaration
Public Property ServiceName As String
'Usage
Dim instance As ServiceInstaller
Dim value As String

value = instance.ServiceName

instance.ServiceName = value

public string ServiceName { get; set; }

public:
property String^ ServiceName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_ServiceName ()

/** @property */
public void set_ServiceName (String value)

public function get ServiceName () : String

public function set ServiceName (value : String)

Eigenschaftenwert

Der Name des zu installierenden Dienstes. Dieser Wert muss festgelegt werden, bevor das Installationsprogramm den Dienst installiert.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Der Wert der ServiceName-Eigenschaft ist ungültig.

Hinweise

Der ServiceName muss unbedingt mit dem ServiceBase.ServiceName aus der von ServiceBase abgeleiteten Klasse übereinstimmen. Der Wert der ServiceBase.ServiceName-Eigenschaft für den Dienst wird üblicherweise in der 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 finden.

Wenn der ServiceName des Dienstinstallationsprogramms festgelegt wird, wird der Source des Ereignisprotokolls derselbe Wert zugewiesen. Daher kann der Dienst Aufrufe von Dienstbefehlen, wie Start oder Stop, automatisch im Anwendungsprotokoll des Computers aufzeichnen.

Hinweis

Wenn auf dem Computer bereits eine Quelle gleichen Namens vorhanden ist, die jedoch ein anderes Protokoll als das Anwendungsprotokoll verwendet, wird eine Ausnahme ausgelöst. Wenn die Quelle vorhanden und mit dem Anwendungsprotokoll verknüpft ist, wird diese zum Aufzeichnen von Dienstbefehlaufrufen verwendet, und es wird keine Ausnahme ausgelöst.

Der ServiceName darf nicht NULL (Nothing in Visual Basic) sein oder die Länge null haben. Die Höchstlänge beträgt 256 Zeichen. Es dürfen keine Schrägstriche ('/'), umgekehrte Schrägstriche ('\') oder ASCII-Zeichen mit Dezimalwerten unter 32 enthalten sein.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ServiceInstaller-Klasse
ServiceInstaller-Member
System.ServiceProcess-Namespace
ServiceBase.ServiceName-Eigenschaft
ServiceInstaller.DisplayName-Eigenschaft

Freigeben über