ServiceController.ServiceName 屬性

定義

命名空間:

System.ServiceProcess

組件:

System.ServiceProcess.ServiceController.dll

組件:

System.ServiceProcess.dll

取得或設定名稱，識別這個執行個體所參考的服務。

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

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

public string ServiceName { get; set; }

public string ServiceName { get; }

[System.ComponentModel.TypeConverter(typeof(System.ServiceProcess.Design.ServiceNameConverter))]
[System.ServiceProcess.ServiceProcessDescription("SPServiceName")]
public string ServiceName { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.ServiceProcess.Design.ServiceNameConverter))]
[System.ServiceProcess.ServiceProcessDescription("SPServiceName")]
[System.ComponentModel.SettingsBindable(true)]
public string ServiceName { get; set; }

member this.ServiceName : string with get, set

member this.ServiceName : string

[<System.ComponentModel.TypeConverter(typeof(System.ServiceProcess.Design.ServiceNameConverter))>]
[<System.ServiceProcess.ServiceProcessDescription("SPServiceName")>]
member this.ServiceName : string with get, set

[<System.ComponentModel.TypeConverter(typeof(System.ServiceProcess.Design.ServiceNameConverter))>]
[<System.ServiceProcess.ServiceProcessDescription("SPServiceName")>]
[<System.ComponentModel.SettingsBindable(true)>]
member this.ServiceName : string with get, set

Public Property ServiceName As String

Public ReadOnly Property ServiceName As String

屬性值

String

名稱，識別這個 ServiceController 執行個體所參考的服務。 預設為空字串 ("")。

屬性

TypeConverterAttribute ServiceProcessDescriptionAttribute SettingsBindableAttribute

例外狀況

ArgumentNullException

ServiceName 為 null。

ArgumentException

ServiceName 屬性的語法無效。

InvalidOperationException

找不到服務。

備註

會 ServiceName 識別服務至服務控制管理員。 變更此屬性會導致 ServiceController 實例系結至另一個服務，而不會變更服務控制管理員的 Microsoft Management Console 嵌入式管理單元顯示的內容。

當您實作自訂服務時，此屬性的值必須與對應 ServiceInstaller 類別的 屬性中 ServiceName 為服務記錄的名稱相同。 在程式碼中， ServiceName 通常會在可執行檔的 函式中 main() 設定 。

當您重設 ServiceName 屬性時，會將這個實例 DisplayName 的 設定為空字串 (「」「) 。