ServiceBase.ServiceName プロパティ

定義

システムでサービスを識別するために使用される短い名前を取得または設定します。

public:
 property System::String ^ ServiceName { System::String ^ get(); void set(System::String ^ value); };
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; }
member this.ServiceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
[<System.ServiceProcess.ServiceProcessDescription("SBServiceName")>]
member this.ServiceName : string with get, set
[<System.ServiceProcess.ServiceProcessDescription("SBServiceName")>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ServiceName : string with get, set
[<System.ServiceProcess.ServiceProcessDescription("SBServiceName")>]
[<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

プロパティ値

サービスの名前。

属性

例外

サービスが既に開始されています。 ServiceName プロパティは、サービスが開始された後は変更できません。

指定された名前が、長さ 0 の文字列であるか、または MaxNameLength より長い文字列です。または、指定された名前にスラッシュまたはバック スラッシュ文字が含まれています。

注釈

ServiceName 、サービス コントロール マネージャーに対するサービスを識別します。 このプロパティの値は、対応するインストーラー クラスの プロパティに ServiceInstaller.ServiceName サービスに記録された名前と同じである必要があります。 コードでは、通常、 ServiceName サービスの は実行可能ファイルの main() 関数で設定されます。

ServiceNameは、 プロパティに関連付EventLogけられている をEventLog.Source指定するためにも使用されます。 これは EventLog 、サービス コマンド情報をアプリケーション ログに書き込むインスタンスです。

ServiceNameイベント ログのソース文字列を提供する は、サービスがイベント ログに書き込む前に設定する必要があります。 ソース名が設定される前にイベント ログにアクセスしようとすると、例外がスローされます。

適用対象

こちらもご覧ください