ServiceBase.ServiceName 屬性

定義

命名空間:

System.ServiceProcess

組件:

System.ServiceProcess.ServiceController.dll

套件:

System.ServiceProcess.ServiceController v9.0.0-rc.2.24473.5

取得或設定用來識別系統服務的簡短名稱。

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

public string ServiceName { get; set; }

member this.ServiceName : string with get, set

Public Property ServiceName As String

屬性值

String

服務的名稱。

例外狀況

InvalidOperationException

已經啟動服務。 一旦已經啟動服務，就無法變更 ServiceName 屬性。

ArgumentException

指定的名稱是零長度字串或比 MaxNameLength 更長，或者指定的名稱包含斜線或反斜線字元。

備註

會 ServiceName 識別服務至服務控制管理員。 這個屬性的值必須與對應安裝程式類別的 屬性中 ServiceInstaller.ServiceName 為服務記錄的名稱相同。 在程式碼中， ServiceName 服務的 通常會在可執行檔的 函式中 main() 設定。

ServiceName也可用來指定 EventLog.Source 與 屬性相關聯的 EventLog 。 這是 EventLog 將服務命令資訊寫入應用程式記錄檔的實例。

提供 ServiceName 事件記錄檔來源字串的 ，必須在服務寫入事件記錄檔之前設定。 嘗試在設定來源名稱之前存取事件記錄檔，會導致擲回例外狀況。

另請參閱

• ServiceName
• Source