ServiceInstaller.Description Eigenschaft

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

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

Attribute

ComVisibleAttribute ServiceProcessDescriptionAttribute

Beispiele

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

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 die Description Eigenschaft, um den Zweck des installierten Diensts für den Benutzer zu beschreiben. Der Benutzer kann die Dienstbeschreibung in Anwendungen anzeigen, in denen Details zu installierten Diensten angezeigt werden.

Beispielsweise können Sie mit Windows XP die Dienstbeschreibung mit dem Befehlszeilenprogramm "Dienststeuerung" (Sc.exe) anzeigen oder die Dienstbeschreibung im Dienstknoten der Computerverwaltungskonsole anzeigen.

Weitere Informationen

• ServiceName
• DisplayName