ServiceInstaller.ServiceName Propriété

Référence

Définition

Espace de noms:: System.ServiceProcess

Assembly:: System.ServiceProcess.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Indique le nom utilisé par le système pour identifier ce service. Cette propriété doit être identique à la propriété ServiceName du service que vous souhaitez installer.

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

Valeur de propriété

String

Nom du service à installer. Cette valeur doit être définie avant que l'utilitaire d'installation n'essaie d'installer le service.

Attributs: TypeConverterAttribute ServiceProcessDescriptionAttribute

Exceptions

ArgumentException

La propriété ServiceName n'est pas valide.

Remarques

Il est essentiel que l' ServiceName soit identique à l' ServiceBase.ServiceName de la classe que vous avez dérivée de ServiceBase . Normalement, la valeur de la ServiceBase.ServiceName propriété pour le service est définie dans la fonction main () de l’exécutable de l’application de service. Le gestionnaire de contrôle des services utilise la ServiceInstaller.ServiceName propriété pour localiser le service dans cet exécutable.

Lorsque vous définissez le ServiceName du programme d’installation du service, le Source du journal des événements associé est défini sur la même valeur. Cela permet au service d’enregistrer automatiquement les commandes de service (telles que les appels de démarrage et d’arrêt) dans le journal des applications sur l’ordinateur.

Notes

Si une source portant le même nom existe déjà sur l’ordinateur, mais dans un journal autre que le journal des applications, une exception est levée. Si la source existe et est associée au journal des applications, cette source est utilisée pour signaler les appels de commande au service et aucune exception n’est levée.

Le ServiceName ne peut pas être null ou avoir une longueur égale à zéro. Sa taille maximale est de 256 caractères. Il ne peut pas non plus contenir de barres obliques avant ou arrière, de « / » ou \ de «», ni de caractères du jeu de caractères ASCII dont la valeur est inférieure à la valeur décimale 32.

S’applique à

Partager via