ServiceController.DisplayName Propiedad

Definición

Espacio de nombres:

System.ServiceProcess

Ensamblado:

System.ServiceProcess.ServiceController.dll

Paquete:

System.ServiceProcess.ServiceController v9.0.0-preview.3.24172.9

Source:

ServiceController.cs

Obtiene o establece un nombre descriptivo para el servicio.

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

public string DisplayName { get; set; }

member this.DisplayName : string with get, set

Public Property DisplayName As String

Valor de propiedad

String

Nombre descriptivo del servicio, que se puede utilizar para identificarlo.

Excepciones

ArgumentNullException

El valor de DisplayName es null.

Win32Exception

Error de acceso a la API del sistema.

InvalidOperationException

No se encontró el servicio.

Ejemplos

En el ejemplo siguiente se usa la ServiceController clase para mostrar el conjunto de servicios que dependen del servicio de registro de eventos.

ServiceController^ sc = gcnew ServiceController(  "Event Log" );
array<ServiceController^>^scServices = nullptr;
if ( sc )
{
   scServices = sc->DependentServices;
}

if ( sc && scServices )
{
   // Display the list of services dependent on the Event Log service.
   if ( scServices->Length == 0 )
   {
      Console::WriteLine(  "There are no services dependent on {0}", sc->ServiceName );
   }
   else
   {
      Console::WriteLine(  "Services dependent on {0}:", sc->ServiceName );
      for each (ServiceController^ scTemp in scServices)
      {
         Console::WriteLine(" {0}", scTemp->DisplayName);
      }
   }
}

ServiceController sc =  new ServiceController("Event Log");
ServiceController[] scServices = sc.DependentServices;

// Display the list of services dependent on the Event Log service.
if (scServices.Length == 0)
{
   Console.WriteLine("There are no services dependent on {0}",
                      sc.ServiceName);
}
else
{
   Console.WriteLine("Services dependent on {0}:",
                      sc.ServiceName);

   foreach (ServiceController scTemp in scServices)
   {
      Console.WriteLine(" {0}", scTemp.DisplayName);
   }
}

Dim sc As New ServiceController("Event Log")
Dim scServices As ServiceController() = sc.DependentServices

' Display the list of services dependent on the Event Log service.
If scServices.Length = 0 Then
   Console.WriteLine("There are no services dependent on {0}", sc.ServiceName)
Else
   Console.WriteLine("Services dependent on {0}:", sc.ServiceName)
   
   Dim scTemp As ServiceController
   For Each scTemp In  scServices
      Console.WriteLine(" {0}", scTemp.DisplayName)
   Next scTemp
End If

Comentarios

Puede establecer en DisplayName una cadena vacía (""), pero al establecer la propiedad en se null produce una excepción.