ServiceInstaller.Description Propriedade

Referência

Definição

Namespace:: System.ServiceProcess

Assembly:: System.ServiceProcess.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define a descrição do serviço.

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

Valor da propriedade

String

A descrição do serviço. O padrão é uma cadeia de caracteres vazia ("").

Atributos: ComVisibleAttribute ServiceProcessDescriptionAttribute

Exemplos

O exemplo de código a seguir define as propriedades de instalação para um novo Windows de serviço. O exemplo define o nome do serviço, juntamente com o nome de exibição e a descrição. Depois de atribuir as propriedades de instalação para o serviço, o exemplo adiciona ServiceInstaller o objeto à Installers coleção.

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

Comentários

Use a Description propriedade para descrever a finalidade do serviço instalado para o usuário. O usuário pode exibir a descrição do serviço em aplicativos que exibem detalhes dos serviços instalados.

Por exemplo, usando Windows XP, você pode exibir a descrição do serviço com o utilitário de linha de comando do Controle de Serviço (Sc.exe) ou exibir a descrição do serviço no nó Serviços do console de Gerenciamento do Computador.

Aplica-se a

Produto	Versões
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8

Partilhar via