ServiceInstaller.ServiceName Eigenschap

Definitie

Naamruimte:

System.ServiceProcess

Assembly:

System.ServiceProcess.dll

Geeft de naam aan die door het systeem wordt gebruikt om deze service te identificeren. Deze eigenschap moet identiek zijn aan de ServiceName service die u wilt installeren.

public:
 property System::String ^ ServiceName { System::String ^ get(); void set(System::String ^ value); };

[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.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

Waarde van eigenschap

String

De naam van de service die moet worden geïnstalleerd. Deze waarde moet worden ingesteld voordat het installatieprogramma de service probeert te installeren.

Kenmerken

TypeConverterAttribute ServiceProcessDescriptionAttribute

Uitzonderingen

ArgumentException

De ServiceName eigenschap is ongeldig.

Opmerkingen

Het is van cruciaal belang dat de ServiceName klasse die u hebt afgeleid, identiek is aan ServiceBase.ServiceName de klasse die u hebt ServiceBaseafgeleid. Normaal gesproken wordt de waarde van de ServiceBase.ServiceName eigenschap voor de service ingesteld binnen de functie Main() van het uitvoerbare bestand van de servicetoepassing. Service Control Manager gebruikt de ServiceInstaller.ServiceName eigenschap om de service in dit uitvoerbare bestand te vinden.

Wanneer u het ServiceName installatieprogramma van de service instelt, wordt het Source bijbehorende gebeurtenislogboek ingesteld op dezelfde waarde. Hierdoor kan de service automatisch serviceopdrachten (zoals starten en stoppen) aanroepen naar het toepassingslogboek op de computer registreren.

Note

Als er al een bron met dezelfde naam op de computer bestaat, maar in een ander logboek dan het toepassingslogboek, wordt er een uitzondering gegenereerd. Als de bron bestaat en is gekoppeld aan het toepassingslogboek, wordt die bron gebruikt om opdrachtoproepen naar de service te rapporteren en wordt er geen uitzondering gegenereerd.

De ServiceName lengte mag niet null of nul zijn. De maximale grootte is 256 tekens. Het mag ook geen slashes, '/' of '\' of tekens uit de ASCII-tekenset bevatten met een waarde die kleiner is dan de decimale waarde 32.

Zie ook

• ServiceName
• DisplayName