ServiceInstaller.ServiceName Propriedade

Referência

Definição

Namespace:: System.ServiceProcess

Assembly:: System.ServiceProcess.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

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

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ServiceName { get; set; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ServiceProcess.ServiceProcessDescription("ServiceInstallerServiceName")]
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")]
public string ServiceName { get; set; }

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ServiceName : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
[<System.ServiceProcess.ServiceProcessDescription("ServiceInstallerServiceName")>]
member this.ServiceName : string with 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 propriedade ServiceName é inválida.

Comentários

É crucial que o ServiceName seja idêntico ao da classe derivada de ServiceBase.ServiceName ServiceBase . Normalmente, o valor da propriedade para o serviço é definido dentro da função Main() do executável do aplicativo ServiceBase.ServiceName de serviço. O Gerenciador de Controle de Serviço usa ServiceInstaller.ServiceName a propriedade para localizar o serviço dentro desse executável.

Quando você definir o do instalador de serviço, o do log de eventos ServiceName associado será definido como o mesmo Source valor. Isso permite que o serviço registre automaticamente comandos de serviço (como Iniciar e Parar) chamadas para o log do aplicativo 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á lançada. Se a origem existir e estiver associada ao log do aplicativo, essa origem será usada para relatar chamadas de comando para o serviço e nenhuma exceção será lançada.

O ServiceName não pode ser ou ter comprimento null 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.

Aplica-se a