ServiceBase.ServiceName プロパティ


システムでサービスを識別するために使用される短い名前を取得または設定します。Gets or sets the short name used to identify the service to the system.

 property System::String ^ ServiceName { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ServiceName { get; set; }
member this.ServiceName : string with get, set
Public Property ServiceName As String


サービスの名前。The name of the service.



サービスが既に開始されています。The service has already been started. ServiceName プロパティは、サービスが開始された後は変更できません。The ServiceName property cannot be changed once the service has started.

指定された名前が、長さ 0 の文字列であるか、または MaxNameLength より長い文字列です。または、指定された名前にスラッシュまたはバック スラッシュ文字が含まれています。The specified name is a zero-length string or is longer than MaxNameLength, or the specified name contains forward slash or backslash characters.


ServiceNameサービスをサービスコントロールマネージャーに識別します。The ServiceName identifies the service to the Service Control Manager. このプロパティの値は、対応するインストーラークラスのServiceInstaller.ServiceNameプロパティでサービスに記録されている名前と同じである必要があります。The value of this property must be identical to the name recorded for the service in the ServiceInstaller.ServiceName property of the corresponding installer class. コードでは、 ServiceName通常、サービスのは実行可能ファイルmain()の関数で設定されます。In code, the ServiceName of the service is usually set in the main() function of the executable.

は、 EventLogプロパティにEventLog.Source関連付けられているを指定するためにも使用されます。 ServiceNameThe ServiceName is also used to specify the EventLog.Source associated with the EventLog property. これEventLogは、サービスコマンド情報をアプリケーションログに書き込むインスタンスです。This EventLog is an instance that writes service command information to the Application log.

イベントServiceNameログのソース文字列を提供するは、サービスがイベントログに書き込む前に設定する必要があります。The ServiceName, which supplies the source string for the event log, must be set before the service writes to the event log. ソース名を設定する前にイベントログにアクセスしようとすると、例外がスローされます。Trying to access the event log before the source name is set causes an exception to be thrown.