システムでサービスを識別するために使用される短い名前を取得または設定します。
Public Property ServiceName As String
[C#]
public string ServiceName {get; set;}
[C++]
public: __property String* get_ServiceName();public: __property void set_ServiceName(String*);
[JScript]
public function get ServiceName() : String;public function set ServiceName(String);
プロパティ値
サービスの名前。
例外
| 例外の種類 | 条件 |
|---|---|
| InvalidOperationException | サービスが既に開始されています。 ServiceName プロパティは、サービスが開始された後は変更できません。 |
| ArgumentException | ServiceName プロパティが無効です。 |
解説
サービスは、 ServiceName によってサービス コントロール マネージャで識別されます。このプロパティの値は、対応するインストーラ クラスの ServiceInstaller.ServiceName プロパティのサービスに対して記録された名前と同じ名前にする必要があります。コードでは、サービスの ServiceName は、通常、実行可能ファイルの main() 関数に設定されます。
ServiceName は、 EventLog プロパティと関連付けられた EventLog.Source を指定するためにも使用されます。この EventLog は、アプリケーション ログにサービス コマンド情報を書き込むインスタンスです。
イベント ログのソース文字列を指定する ServiceName は、サービスがイベント ログに書き込みを行う前に設定する必要があります。ソース名を設定する前にイベント ログにアクセスしようとすると、例外がスローされます。
必要条件
プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
ServiceBase クラス | ServiceBase メンバ | System.ServiceProcess 名前空間 | ServiceInstaller.ServiceName | EventLog.Source