ServiceInstaller.ServiceName Propriedade

Definição

Namespace:

System.ServiceProcess

Assembly:

System.ServiceProcess.dll

Indica o nome usado pelo sistema para identificar esse serviço. Essa propriedade deve ser idêntica ao ServiceName serviço que você deseja instalar.

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

[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.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

Valor da propriedade

String

O nome do serviço a ser instalado. Esse valor deve ser definido antes que o utilitário de instalação tente instalar o serviço.

Atributos

TypeConverterAttribute ServiceProcessDescriptionAttribute

Exceções

ArgumentException

A ServiceName propriedade é inválida.

Comentários

É crucial que seja ServiceName idêntico à ServiceBase.ServiceName classe da ServiceBasequal você deriva. Normalmente, o valor da ServiceBase.ServiceName propriedade para o serviço é definido dentro da função Main() do executável do aplicativo de serviço. O Service Control Manager usa a ServiceInstaller.ServiceName propriedade para localizar o serviço dentro desse executável.

Quando você define o ServiceName instalador de serviço, o Source log de eventos associado é definido como o mesmo valor. Isso permite que o serviço registre automaticamente comandos de serviço (como Iniciar e Parar) para o log de aplicativos no computador.

Observação

Se uma origem com o mesmo nome já existir no computador, mas em um log diferente do log do aplicativo, uma exceção será gerada. Se a origem existir e estiver associada ao log do aplicativo, essa origem será usada para relatar chamadas de comando ao serviço e nenhuma exceção será gerada.

Não ServiceName pode ser null ou ter comprimento zero. Seu tamanho máximo é de 256 caracteres. Ele também não pode conter barras para frente ou para trás, '/' ou '\' ou caracteres do conjunto de caracteres ASCII com valor menor que o valor decimal 32.

Confira também

• ServiceName
• DisplayName