ServiceInstaller.ServiceName 屬性

定義

命名空間:

System.ServiceProcess

組件:

System.ServiceProcess.dll

表示系統用來識別此服務的名稱。 這個屬性必須與您想要安裝之服務的 ServiceName 相同。

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

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

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

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

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ServiceName : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
[<System.ServiceProcess.ServiceProcessDescription("ServiceInstallerServiceName")>]
member this.ServiceName : string with get, set

[<System.ServiceProcess.ServiceProcessDescription("ServiceInstallerServiceName")>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ServiceName : string with get, set

Public Property ServiceName As String

屬性值

String

要安裝的服務名稱， 這個值必須在安裝公用程式嘗試安裝服務之前設定。

屬性

TypeConverterAttribute ServiceProcessDescriptionAttribute

例外狀況

ArgumentException

ServiceName 屬性為無效。

備註

請務必與 ServiceName ServiceBase.ServiceName 您衍生自的類別相同 ServiceBase 。 一般來說，服務的屬性值 ServiceBase.ServiceName 是在服務應用程式可執行檔的主要 () 函式中設定。 服務控制管理員會使用 ServiceInstaller.ServiceName 屬性來尋找這個可執行檔內的服務。

當您設定 ServiceName 服務安裝程式的時， Source 相關聯之事件記錄檔的會設定為相同的值。 這可讓服務自動記錄服務命令 (例如，啟動和停止) 呼叫電腦上的應用程式記錄檔。

注意

如果電腦上已經有相同名稱的來源，但是在應用程式記錄檔以外的記錄檔中，則會擲回例外狀況。 如果來源存在且與應用程式記錄檔相關聯，該來源會用來向服務報告命令呼叫，且不會擲回例外狀況。

ServiceName不可以是 null 或長度為零。 其大小上限為256個字元。 它也不能包含正斜線或反斜線、'/' 或 ' \ '，或 ASCII 字元集中值小於十進位值32的字元。

另請參閱

• ServiceName
• DisplayName