EventLogInstaller.Source プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ログに登録するソース名を取得または設定します。
public:
property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set
Public Property Source As String
プロパティ値
エントリのソースとしてイベント ログに登録する名前。 既定値は空の文字列 ("") です。
- 属性
注釈
イベント ソースは、イベントをログに記録する内容を示します。 多くの場合、アプリケーションの名前、または大規模なアプリケーション内のコンポーネントの名前です。
インストーラーは、 Source プロパティの値を使用して、エントリの有効なソースとしてアプリケーションをイベント ログに登録します。 新しいソース名は、既存のソース名または既存のイベント ログ名と一致できません。 各ソースは、一度に 1 つのイベント ログにのみ書き込むことができます。ただし、アプリケーションは複数のソースを使用して複数のイベント ログに書き込むことができます。 たとえば、アプリケーションで、異なるイベント ログまたは異なるリソース ファイル用に構成された複数のソースが必要な場合があります。
アプリケーションとサービスは、アプリケーション ログまたはカスタム ログに書き込む必要があります。 デバイス ドライバーは、システム ログに書き込む必要があります。 インストーラーの実行前にログ名を指定しないと、インストーラーによってソースがアプリケーション ログに登録されます。 存在しないログの名前を指定すると、システムはそのログに Source を登録しますが、ログは最初のエントリが書き込まれるまで作成されません。
EventLogInstallerを使用して、新規または既存のイベント ログの新しいソースを登録します。既存のソースを変更するEventLogInstallerは使用しないでください。 EventLogInstaller クラスは、指定したインストール プロパティに一致するように既存のソースの構成プロパティを変更しません。 Source プロパティが、コンピューター上の別のイベント ログに登録されているソース名と一致する場合、Install メソッドは例外をスローします。 Source プロパティが、Log プロパティで指定されたのと同じイベント ログに既に登録されているソース名と一致する場合、Install メソッドはソースを登録しません。
イベント ログとソースの動作の詳細については、LogおよびSourceプロパティのEventLog クラスのドキュメントを参照してください。