ServiceBase.ServiceName-Eigenschaft

Artikel
08/20/2007

Ruft den zur Bezeichnung des Diensts beim System verwendeten kurzen Namen ab oder legt diesen fest.

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

Syntax

'Declaration
Public Property ServiceName As String
'Usage
Dim instance As ServiceBase
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 Diensts.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Der Dienst wurde bereits gestartet. Die ServiceName-Eigenschaft kann nach dem Start des Diensts nicht mehr geändert werden.
ArgumentException	Der Wert der ServiceName-Eigenschaft ist ungültig.

Hinweise

ServiceName gibt den Dienst für den Dienststeuerungs-Manager an. Der Wert dieser Eigenschaft muss mit dem Namen identisch sein, der für den Dienst in der ServiceInstaller.ServiceName-Eigenschaft der entsprechenden Klasse des Installationsprogramms aufgezeichnet wurde. In Code wird der ServiceName des Diensts i. d. R. in der main()-Funktion der ausführbaren Datei festgelegt.

Mit dem ServiceName wird außerdem die der EventLog-Eigenschaft zugeordnete EventLog.Source angegeben. EventLog ist eine Instanz, die Informationen über Dienstbefehle in das Anwendungsprotokoll schreibt.

Der ServiceName, der die Quellzeichenfolge für das Ereignisprotokoll bereitstellt, muss festgelegt werden, bevor der Dienst in das Ereignisprotokoll schreibt. Bei einem versuchten Zugriff auf das Ereignisprotokoll wird, wenn der Quellname noch nicht festgelegt wurde, eine Ausnahme ausgelöst.

.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

ServiceBase-Klasse
ServiceBase-Member
System.ServiceProcess-Namespace
ServiceInstaller.ServiceName
EventLog.Source

Freigeben über