ServiceInstaller.ServiceName Propiedad

Definición

Indica el nombre que utiliza el sistema para identificar este servicio.Indicates the name used by the system to identify this service. Esta propiedad tiene que ser idéntica a la propiedad ServiceName del servicio que se desea 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 de propiedad

El nombre del servicio que se va a instalar.The name of the service to be installed. Este valor tiene que establecerse antes de que la utilidad de instalación intente instalar el servicio.This value must be set before the install utility attempts to install the service.

Atributos

Excepciones

La propiedad ServiceName no es válida.The ServiceName property is invalid.

Comentarios

Es fundamental que ServiceName sea idéntico ServiceBase.ServiceName al de ServiceBasela clase de la que deriva.It is crucial that the ServiceName be identical to the ServiceBase.ServiceName of the class you derived from ServiceBase. Normalmente, el valor de la ServiceBase.ServiceName propiedad para el servicio se establece dentro de la función Main () del ejecutable de la aplicación de servicio.Normally, the value of the ServiceBase.ServiceName property for the service is set within the Main() function of the service application's executable. El administrador de control de servicios ServiceInstaller.ServiceName utiliza la propiedad para buscar el servicio en este archivo ejecutable.The Service Control Manager uses the ServiceInstaller.ServiceName property to locate the service within this executable.

Cuando se establece el ServiceName del instalador del servicio, el Source del registro de eventos asociado se establece en el mismo valor.When you set the ServiceName of the service installer, the Source of the associated event log is set to the same value. Esto permite al servicio registrar automáticamente los comandos del servicio (como iniciar y detener) las llamadas al registro de la aplicación en el equipo.This allows the service to automatically log service commands (such as Start and Stop) calls to the Application log on the computer.

Nota

Si ya existe un origen con el mismo nombre en el equipo, pero en un registro que no sea el registro de la aplicación, se producirá una excepción.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. Si el origen existe y está asociado al registro de la aplicación, ese origen se utiliza para notificar las llamadas de comandos al servicio y no se produce ninguna excepción.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.

No puede ser null ni tener longitud cero. ServiceNameThe ServiceName cannot be null or have zero length. Su tamaño máximo es de 256 caracteres.Its maximum size is 256 characters. Tampoco puede contener barras diagonales o de retroceso, '/' ni '\', ni caracteres del juego de caracteres ASCII con un valor inferior al valor decimal 32.It also cannot contain forward or backward slashes, '/' or '\', or characters from the ASCII character set with value less than decimal value 32.

Se aplica a

Consulte también: