ServiceInstaller.Description Eigenschaft

Referenz

Definition

Namespace:: System.ServiceProcess

Assembly:: System.ServiceProcess.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Beschreibung des Dienstes ab oder legt diese fest.

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

[System.Runtime.InteropServices.ComVisible(false)]
[System.ServiceProcess.ServiceProcessDescription("ServiceInstallerDescription")]
public string Description { get; set; }

[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.ServiceProcess.ServiceProcessDescription("ServiceInstallerDescription")>]
member this.Description : string with get, set

Public Property Description As String

Eigenschaftswert

String

Die Beschreibung des Dienstes. Der Standardwert ist eine leere Zeichenfolge ("").

Attribute: ComVisibleAttribute ServiceProcessDescriptionAttribute

Beispiele

Im folgenden Codebeispiel werden die Installationseigenschaften für eine neue Windows-Dienstanwendung definiert. Im Beispiel wird der Dienstname zusammen mit dem Anzeigenamen und der Beschreibung angegeben. Nach dem Zuweisen der Installationseigenschaften für den Dienst wird im Beispiel das ServiceInstaller -Objekt zur -Auflistung Installers addiert.

simpleServiceProcessInstaller = new ServiceProcessInstaller();
simpleServiceInstaller = new ServiceInstaller();

// Set the account properties for the service process.
simpleServiceProcessInstaller.Account = ServiceAccount.LocalService;

// Set the installation properties for the service.
// The ServiceInstaller.ServiceName must match the
// ServiceBase.ServiceName set in the service
// implementation that is installed by this installer.
simpleServiceInstaller.ServiceName = "SimpleService";

simpleServiceInstaller.DisplayName = "Simple Service";
simpleServiceInstaller.Description = "A simple service that runs on the local computer.";
simpleServiceInstaller.StartType = ServiceStartMode.Manual;

// Add the installers to the Installer collection.
Installers.Add(simpleServiceInstaller);
Installers.Add(simpleServiceProcessInstaller);

' Start the service.
Protected Overrides Sub OnStart(ByVal args() As String) 
    ' Start a separate thread that does the actual work.
    If workerThread Is Nothing OrElse(workerThread.ThreadState And System.Threading.ThreadState.Unstarted Or System.Threading.ThreadState.Stopped) <> 0 Then
        Trace.WriteLine(DateTime.Now.ToLongTimeString() + " - Starting the service worker thread.", "OnStart")
        
        workerThread = New Thread(New ThreadStart(AddressOf ServiceWorkerMethod))
        workerThread.Start()
    End If
    If Not (workerThread Is Nothing) Then
        Trace.WriteLine(DateTime.Now.ToLongTimeString() + " - Worker thread state = " + workerThread.ThreadState.ToString(), "OnStart")
    End If

End Sub

Hinweise

Verwenden Sie Description die -Eigenschaft, um den Zweck des installierten Diensts für den Benutzer zu beschreiben. Der Benutzer kann die Dienstbeschreibung in Anwendungen anzeigen, die Details für installierte Dienste anzeigen.

Mithilfe von Windows XP können Sie beispielsweise die Dienstbeschreibung mit dem Befehlszeilenprogramm dienststeuerung (Sc.exe) oder die Dienstbeschreibung im Knoten Dienste der Computerverwaltungskonsole anzeigen.

Gilt für

Freigeben über