ServiceController.DisplayName Propriété

Définition

Espace de noms:

System.ServiceProcess

Assembly:

System.ServiceProcess.ServiceController.dll

Assembly:

System.ServiceProcess.dll

Obtient ou définit un nom convivial pour le service.

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

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

public string DisplayName { get; set; }

public string DisplayName { get; }

[System.ServiceProcess.ServiceProcessDescription("SPDisplayName")]
public string DisplayName { get; set; }

member this.DisplayName : string with get, set

member this.DisplayName : string

[<System.ServiceProcess.ServiceProcessDescription("SPDisplayName")>]
member this.DisplayName : string with get, set

Public Property DisplayName As String

Public ReadOnly Property DisplayName As String

Valeur de propriété

String

Nom convivial du service, qui peut servir à identifier celui-ci.

Attributs

ServiceProcessDescriptionAttribute

Exceptions

ArgumentNullException

DisplayName a la valeur null.

Win32Exception

Une erreur s'est produite lors de l'accès à une API système.

InvalidOperationException

Le service est introuvable.

Exemples

L’exemple suivant utilise la classe pour afficher l’ensemble ServiceController de services qui dépendent du service Journal des événements.

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

Remarques

Vous pouvez définir la DisplayName valeur sur une chaîne vide («  »), mais définir la propriété pour null lever une exception.