EventLogInstaller.Source プロパティ

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

EventLogInstaller.Source プロパティ

ログに登録するソース名を取得または設定します。

名前空間: System.Diagnostics
アセンブリ: System.Configuration.Install (system.configuration.install.dll 内)
構文

Visual Basic (宣言)

Public Property Source As
 String

Visual Basic (使用法)

Dim instance As EventLogInstaller
Dim value As String

value = instance.Source

instance.Source = value

C#

public string Source { get;
 set; }

C++

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

J#

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

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

JScript

public function get Source
 () : String

public function set Source
 (value : String)

プロパティ値
エントリのソースとしてイベント ログに登録する名前。既定値は空の文字列 ("") です。

解説

イベント ソースは、何によってイベントがログに記録されるかを示します。通常はアプリケーションの名前か、アプリケーションが大規模な場合はコンポーネントの名前を指定します。

インストーラは、Source プロパティの値を使用して、イベント ログにエントリの有効なソースとしてアプリケーションを登録します。新しいソース名は、既存のソース名または既存のイベント ログ名と異なっている必要があります。各ソースは、同時に 1 つのイベント ログだけに書き込むことができます。ただし、アプリケーションは複数のソースを使用して、複数のイベント ログに書き込むことができます。たとえば、アプリケーションには、異なるイベント ログまたは異なるリソース ファイル用に構成された複数のソースが必要になる場合があります。

アプリケーションおよびサービスは、アプリケーション ログまたはカスタム ログに書き込みます。デバイス ドライバは、システム ログに書き込みます。インストーラを実行する前にログ名を指定しない場合、インストーラはアプリケーション ログにソースを登録します。存在しないログ名を指定した場合は、Source がそのログに登録されますが、そのログは最初のエントリが書き込まれるまで作成されません。

新規のソースを新規または既存のイベント ログに登録するには、EventLogInstaller を使用します。既存のソースを変更する場合は、EventLogInstaller を使用しないでください。EventLogInstaller クラスは、指定されたインストール プロパティと一致するように既存のソースの構成プロパティを変更しません。Source プロパティが、コンピュータの別のイベント ログに登録されているソース名と一致する場合、Install メソッドは例外をスローします。Source プロパティが、Log プロパティに指定された同じイベント ログに既に登録されているソース名と一致する場合、Install メソッドはソースを登録しません。

イベント ログとイベント ソースの動作の詳細については、Log プロパティと Source プロパティの EventLog クラスの説明を参照してください。

.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

参照

関連項目
EventLogInstaller クラス
EventLogInstaller メンバ
System.Diagnostics 名前空間
EventLog.Source プロパティ
EventLog クラス