ServiceBase.ServiceName プロパティ

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

ServiceBase.ServiceName プロパティ

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

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

Visual Basic (宣言)

Public Property ServiceName As
 String

Visual Basic (使用法)

Dim instance As ServiceBase
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)

プロパティ値
サービスの名前。

例外

例外の種類	条件
InvalidOperationException	サービスが既に開始されています。ServiceName プロパティは、サービスが開始された後は変更できません。
ArgumentException	ServiceName プロパティが無効です。

解説

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

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

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

.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

参照

関連項目
ServiceBase クラス
ServiceBase メンバ
System.ServiceProcess 名前空間
ServiceInstaller.ServiceName
EventLog.Source