ServiceBase.ServiceName Właściwość

Definicja

Pobiera lub ustawia krótką nazwę używaną do identyfikowania usługi w systemie.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); };
public string ServiceName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ServiceProcess.ServiceProcessDescription("SBServiceName")]
public string ServiceName { get; set; }
[System.ServiceProcess.ServiceProcessDescription("SBServiceName")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ServiceName { get; set; }
[System.ServiceProcess.ServiceProcessDescription("SBServiceName")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ServiceName { get; set; }
member this.ServiceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
[<System.ServiceProcess.ServiceProcessDescription("SBServiceName")>]
member this.ServiceName : string with get, set
[<System.ServiceProcess.ServiceProcessDescription("SBServiceName")>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ServiceName : string with get, set
[<System.ServiceProcess.ServiceProcessDescription("SBServiceName")>]
[<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

Wartość właściwości

String

Nazwa usługi.The name of the service.

Atrybuty

Wyjątki

Usługa została już uruchomiona.The service has already been started. ServiceNameNie można zmienić właściwości po rozpoczęciu usługi.The ServiceName property cannot be changed once the service has started.

Określona nazwa jest ciągiem o zerowej długości lub jest dłuższa lub większa niż MaxNameLength lub określona nazwa zawiera ukośnik lub ukośnik odwrotny.The specified name is a zero-length string or is longer than MaxNameLength, or the specified name contains forward slash or backslash characters.

Uwagi

ServiceNameIdentyfikuje usługę dla menedżera kontroli usług.The ServiceName identifies the service to the Service Control Manager. Wartość tej właściwości musi być taka sama jak nazwa zarejestrowana dla usługi we ServiceInstaller.ServiceName Właściwości odpowiedniej klasy Instalatora.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. W kodzie ServiceName Usługa jest zazwyczaj ustawiana w main() funkcji pliku wykonywalnego.In code, the ServiceName of the service is usually set in the main() function of the executable.

ServiceNameJest również używany do określenia EventLog.Source skojarzone z EventLog właściwością.The ServiceName is also used to specify the EventLog.Source associated with the EventLog property. EventLogJest to wystąpienie, które zapisuje informacje o poleceniu usługi w dzienniku aplikacji.This EventLog is an instance that writes service command information to the Application log.

ServiceName, Która dostarcza ciąg źródłowy dziennika zdarzeń, musi być ustawiona przed zapisem usługi do dziennika zdarzeń.The ServiceName, which supplies the source string for the event log, must be set before the service writes to the event log. Próba uzyskania dostępu do dziennika zdarzeń przed ustawieniem nazwy źródła powoduje zgłoszenie wyjątku.Trying to access the event log before the source name is set causes an exception to be thrown.

Dotyczy

Zobacz też