閱讀英文

共用方式為

ServiceBase.ServiceName 屬性

  • 參考

定義

命名空間:
System.ServiceProcess
組件:
System.ServiceProcess.ServiceController.dll
組件:
System.ServiceProcess.dll
套件:
System.ServiceProcess.ServiceController v10.0.0-preview.2.25163.2
來源:
ServiceBase.cs
來源:
ServiceBase.cs
來源:
ServiceBase.cs

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

public string ServiceName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ServiceProcess.ServiceProcessDescription("SBServiceName")]
public string ServiceName { get; set; }
[System.ServiceProcess.ServiceProcessDescription("SBServiceName")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ServiceName { get; set; }
[System.ServiceProcess.ServiceProcessDescription("SBServiceName")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ServiceName { get; set; }

屬性值

String

服務的名稱。

屬性
TypeConverterAttribute ServiceProcessDescriptionAttribute

例外狀況

InvalidOperationException

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

ArgumentException

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

備註

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

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

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

適用於

產品 版本
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

另請參閱