ServiceInstaller.ServiceName プロパティ

このサービスを識別するためにシステムで使用される名前を示します。このプロパティは、インストールするサービスの ServiceBase.ServiceName と同じにする必要があります。

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);

プロパティ値

インストールされるサービスの名前。この値は、インストール ユーティリティがサービスをインストールする前に設定する必要があります。

例外

解説

ServiceName は、 ServiceBase から派生したクラスの ServiceBase.ServiceName と必ず同じにする必要があります。通常、サービスの ServiceBase.ServiceName プロパティの値は、サービス アプリケーションの実行可能ファイルの Main() 関数内で設定されます。サービス コントロール マネージャは、 ServiceInstaller.ServiceName プロパティを使用して、この実行可能ファイル内でサービスを検索します。

サービス インストーラの ServiceName を設定すると、関連付けられたイベント ログの Source は同じ値に設定されます。このように設定すると、サービスでは、サービス コマンド (Start、Stop など) の呼び出しをコンピュータのアプリケーション ログに自動的に記録できます。

メモ   同じ名前のソースがコンピュータに既に存在する場合でも、アプリケーション ログ以外のログ内にある場合は、例外がスローされます。同じ名前のソースが存在し、アプリケーション ログに関連付けられている場合、ソースはサービスにコマンド呼び出しをレポートするために使用され、例外はスローされません。

ServiceName は、 null 参照 (Visual Basic では Nothing) でも、長さ 0 でもありません。最大文字数は、256 文字です。スラッシュまたはバック スラッシュ ('/' または '\')、あるいは値が 32 未満の 10 進数に設定されている ASCII 文字セットの文字を含むことはできません。

必要条件

プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

• 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用

参照

ServiceInstaller クラス | ServiceInstaller メンバ | System.ServiceProcess 名前空間 | ServiceBase.ServiceName | DisplayName