ServiceBase.ServiceName Propriedade

  • Referência

Definição

Namespace:
System.ServiceProcess
Assembly:
System.ServiceProcess.ServiceController.dll
Assembly:
System.ServiceProcess.dll
Pacote:
System.ServiceProcess.ServiceController v8.0.0
Pacote:
System.ServiceProcess.ServiceController v9.0.0-preview.3.24172.9
Origem:
ServiceBase.cs
Origem:
ServiceBase.cs
Origem:
ServiceBase.cs
Origem:
ServiceBase.cs

Obtém ou define o nome curto usado para identificar o serviço no sistema.

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

Valor da propriedade

String

O nome do serviço.

Atributos
TypeConverterAttribute ServiceProcessDescriptionAttribute

Exceções

InvalidOperationException

O serviço já foi iniciado. A propriedade ServiceName não pode ser alterada depois que o serviço é iniciado.

ArgumentException

O nome especificado é uma cadeia de caracteres de tamanho zero ou é maior que MaxNameLength ou o nome especificado contém caracteres de barra ou barra invertida.

Comentários

O ServiceName identifica o serviço para o Service Control Manager. O valor dessa propriedade deve ser idêntico ao nome registrado para o serviço na ServiceInstaller.ServiceName propriedade da classe do instalador correspondente. No código, o ServiceName do serviço geralmente é definido na main() função do executável.

O ServiceName também é usado para especificar o EventLog.Source associado à EventLog propriedade . Essa EventLog é uma instância que grava informações de comando de serviço no log do aplicativo.

O ServiceName, que fornece a cadeia de caracteres de origem para o log de eventos, deve ser definido antes que o serviço grave no log de eventos. Tentar acessar o log de eventos antes que o nome de origem seja definido faz com que uma exceção seja gerada.

Aplica-se a

Confira também