Export (0) Print
Expand All

ServiceController.DisplayName Property

Gets or sets a friendly name for the service.

Namespace: System.ServiceProcess
Assembly: System.ServiceProcess (in system.serviceprocess.dll)

public:
property String^ DisplayName {
	String^ get ();
	void set (String^ value);
}
/** @property */
public String get_DisplayName ()

/** @property */
public void set_DisplayName (String value)

public function get DisplayName () : String

public function set DisplayName (value : String)

Property Value

The friendly name of the service, which can be used to identify the service.

Exception typeCondition

ArgumentNullException

The DisplayName is a null reference (Nothing in Visual Basic).

Win32Exception

An error occurred when accessing a system API.

You can set the DisplayName to an empty string (""), but setting the property to a null reference (Nothing in Visual Basic) throws an exception.

The following example uses the ServiceController class to display the set of services that are dependent on the Event Log service.

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.get_DependentServices();
// Display the list of services dependent on the Event Log service.
if (scServices.get_Length() == 0) {
    Console.WriteLine("There are no services dependent on {0}",
        sc.get_ServiceName());
}
else {
    Console.WriteLine("Services dependent on {0}:", 
        sc.get_ServiceName());
    ServiceController scTemp = new ServiceController();
    for  (int iCtr = 0; iCtr < scServices.get_Length(); iCtr++) {
        scTemp = scServices[iCtr];
        Console.WriteLine(" {0}", scTemp.get_DisplayName());
    }
}

  • Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft