ServiceInstaller.ServiceName プロパティ

.NET Framework クラス ライブラリ リファレンス

ServiceInstaller.ServiceName プロパティ

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

名前空間: System.ServiceProcess
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public Property ServiceName As
 String

Visual Basic (使用法)

Dim instance As ServiceInstaller
Dim value As String

value = instance.ServiceName

instance.ServiceName = value

C#

public string ServiceName { get;
 set; }

C++

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

J#

/** @property */
public String get_ServiceName ()

/** @property */
public void set_ServiceName (String value)

JScript

public function get ServiceName
 () : String

public function set ServiceName
 (value : String)

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

例外

例外の種類	条件
ArgumentException	ServiceName プロパティが無効です。

解説

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

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

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

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ServiceInstaller クラス
ServiceInstaller メンバ
System.ServiceProcess 名前空間
ServiceBase.ServiceName プロパティ
ServiceInstaller.DisplayName プロパティ