ServiceInstaller.ServiceName ServiceInstaller.ServiceName ServiceInstaller.ServiceName ServiceInstaller.ServiceName Property

Definição

Indica o nome usado pelo sistema para identificar esse serviço.Indicates the name used by the system to identify this service. Esta propriedade deve ser idêntica ao ServiceName do serviço que você deseja instalar.This property must be identical to the ServiceName of the service you want to install.

public:
 property System::String ^ ServiceName { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ServiceProcess.ServiceProcessDescription("ServiceInstallerServiceName")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ServiceName { get; set; }
member this.ServiceName : string with get, set
Public Property ServiceName As String

Valor da propriedade

O nome do serviço a ser instalado.The name of the service to be installed. Esse valor deve ser definido antes do utilitário de instalação tente instalar o serviço.This value must be set before the install utility attempts to install the service.

Exceções

Comentários

É crucial que o ServiceName ser idêntico de ServiceBase.ServiceName da classe derivada de ServiceBase.It is crucial that the ServiceName be identical to the ServiceBase.ServiceName of the class you derived from ServiceBase. Normalmente, o valor da ServiceBase.ServiceName propriedade para o serviço é definida dentro da função Main () do executável do aplicativo de serviço.Normally, the value of the ServiceBase.ServiceName property for the service is set within the Main() function of the service application's executable. O Gerenciador de controle de serviço usa o ServiceInstaller.ServiceName propriedade para localizar o serviço dentro deste executável.The Service Control Manager uses the ServiceInstaller.ServiceName property to locate the service within this executable.

Quando você define o ServiceName do instalador do serviço, o Source do log de eventos associado é definido como o mesmo valor.When you set the ServiceName of the service installer, the Source of the associated event log is set to the same value. Isso permite que o serviço para automaticamente fazer chamadas de comandos (como o início e parada) de serviço para o log de aplicativo no computador.This allows the service to automatically log service commands (such as Start and Stop) calls to the Application log on the computer.

Observação

Se uma fonte com o mesmo nome já existir no computador, mas em um log que não sejam o log de aplicativo, uma exceção será lançada.If a source by the same name already exists on the computer, but in a log other than the Application log, an exception will be thrown. Se a origem existe e está associada com o log de aplicativo, essa fonte é usada para chamadas de comando para o serviço de relatório, e nenhuma exceção é lançada.If the source exists and is associated with the Application log, that source is used to report command calls to the service, and no exception is thrown.

O ServiceName não pode ser null ou tem comprimento zero.The ServiceName cannot be null or have zero length. Seu tamanho máximo é de 256 caracteres.Its maximum size is 256 characters. Ele também não pode conter barras de frente ou para trás, '/' ou '\', ou caracteres ASCII de conjunto com valor menor que o valor decimal 32 caracteres.It also cannot contain forward or backward slashes, '/' or '\', or characters from the ASCII character set with value less than decimal value 32.

Aplica-se a

Veja também