ServiceInstaller.ServiceName Propriedade

Definição

Indica o nome usado pelo sistema para identificar este serviço. Esta propriedade deve ser idêntica à ServiceName do serviço que pretende 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 de Propriedade

O nome do serviço a instalar. Este valor deve ser definido antes de a utilidade de instalação tentar instalar o serviço.

Atributos

Exceções

A ServiceName propriedade é inválida.

Observações

É crucial que sejam ServiceName idênticos à ServiceBase.ServiceName classe da qual ServiceBasederivaste. Normalmente, o valor da ServiceBase.ServiceName propriedade do serviço é definido dentro da função Main() do executável da aplicação de serviço. O Service Control Manager utiliza a ServiceInstaller.ServiceName propriedade para localizar o serviço dentro deste executável.

Quando defines o ServiceName do instalador de serviço, o Source do registo de eventos associado é definido com o mesmo valor. Isto permite ao serviço registar automaticamente chamadas de comandos de serviço (como Iniciar e Parar) no registo de aplicações no computador.

Note

Se já existir uma fonte com o mesmo nome no computador, mas num registo diferente do registo de aplicação, será lançada uma exceção. Se a fonte existir e estiver associada ao registo de aplicação, essa fonte é usada para reportar chamadas de comando ao serviço, e não é lançada nenhuma exceção.

Não ServiceName podem ser null nem têm comprimento zero. O seu tamanho máximo é de 256 caracteres. Também não pode conter barras para a frente ou para trás, '/' ou '\', ou caracteres do conjunto de caracteres ASCII com valor inferior ao valor decimal 32.

Aplica-se a

Ver também