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

Definizione

Specifica il nome utilizzato dal sistema per identificare il servizio.Indicates the name used by the system to identify this service. È necessario che questa proprietà sia identica alla proprietà ServiceName del servizio che si desidera installare.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

Valore della proprietà

Nome del servizio da installare.The name of the service to be installed. È necessario che questo valore sia impostato prima che l'utilità di installazione tenti di installare il servizio.This value must be set before the install utility attempts to install the service.

Eccezioni

La proprietà ServiceName non è valida.The ServiceName property is invalid.

Commenti

È fondamentale che il ServiceName essere identica al ServiceBase.ServiceName della classe è derivata da ServiceBase.It is crucial that the ServiceName be identical to the ServiceBase.ServiceName of the class you derived from ServiceBase. In genere, il valore della ServiceBase.ServiceName per il servizio viene impostata all'interno della funzione Main () del file eseguibile dell'applicazione del servizio.Normally, the value of the ServiceBase.ServiceName property for the service is set within the Main() function of the service application's executable. Gestione controllo servizi utilizza il ServiceInstaller.ServiceName proprietà per individuare il servizio all'interno di questo eseguibile.The Service Control Manager uses the ServiceInstaller.ServiceName property to locate the service within this executable.

Quando si impostano i ServiceName del programma di installazione del servizio, il Source del log eventi associato è impostato sullo stesso valore.When you set the ServiceName of the service installer, the Source of the associated event log is set to the same value. In questo modo il servizio registrare automaticamente le chiamate di comandi (ad esempio avvio e arresto) del servizio nel registro applicazioni nel computer.This allows the service to automatically log service commands (such as Start and Stop) calls to the Application log on the computer.

Nota

Se un'origine con lo stesso nome esiste già nel computer, ma in un log diverso da nel registro dell'applicazione, verrà generata un'eccezione.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 l'origine esista e sia associato con il registro applicazioni, tale origine viene usata per segnalare le chiamate di comandi al servizio e viene generata alcuna eccezione.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.

Il ServiceName non può essere null o avere lunghezza zero.The ServiceName cannot be null or have zero length. La dimensione massima è 256 caratteri.Its maximum size is 256 characters. Non può inoltre contenere barre avanti o indietro, '/' o '\', o caratteri ASCII set con valore inferiore al valore decimale 32 caratteri.It also cannot contain forward or backward slashes, '/' or '\', or characters from the ASCII character set with value less than decimal value 32.

Si applica a

Vedi anche