ServiceController.DisplayName 屬性

定義

命名空間:

System.ServiceProcess

組件:

System.ServiceProcess.ServiceController.dll

組件:

System.ServiceProcess.dll

取得或設定服務的易記名稱。

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

屬性值

String

服務的易記名稱，可用來識別服務。

屬性

ServiceProcessDescriptionAttribute

例外狀況

ArgumentNullException

DisplayName 為 null。

Win32Exception

存取系統 API 時發生的錯誤。

InvalidOperationException

找不到服務。

範例

下列範例會 ServiceController 使用 類別來顯示相依于事件記錄檔服務的一組服務。

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

備註

您可以將 設定 DisplayName 為空字串 (「」) ，但將 屬性設定為 null 會擲回例外狀況。