EventLog.SynchronizingObject プロパティ

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

EventLog.SynchronizingObject プロパティ

EventLog エントリ書き込みイベントの結果として発行されるイベント ハンドラ呼び出しをマーシャリングするために使用するオブジェクトを取得または設定します。

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

Visual Basic (宣言)

Public Property SynchronizingObject As
 ISynchronizeInvoke

Visual Basic (使用法)

Dim instance As EventLog
Dim value As ISynchronizeInvoke

value = instance.SynchronizingObject

instance.SynchronizingObject = value

C#

public ISynchronizeInvoke SynchronizingObject { get;
 set; }

C++

public:
property ISynchronizeInvoke^ SynchronizingObject {
    ISynchronizeInvoke^ get ();
    void set (ISynchronizeInvoke^ value);
}

J#

/** @property */
public ISynchronizeInvoke get_SynchronizingObject ()

/** @property */
public void set_SynchronizingObject (ISynchronizeInvoke
 value)

JScript

public function get SynchronizingObject
 () : ISynchronizeInvoke

public function set SynchronizingObject
 (value : ISynchronizeInvoke)

プロパティ値
イベント ログの EntryWritten イベントの結果として発行されるイベント ハンドラ呼び出しをマーシャリングするために使用する ISynchronizeInvoke。

解説

メモ
このプロパティに適用される HostProtectionAttribute 属性の Resources プロパティの値は、Synchronization です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

SynchronizingObject が null 参照 (Visual Basic では Nothing) の場合、EntryWritten イベントを処理するメソッドはシステムのスレッド プールのスレッドで呼び出されます。システム スレッド プールの詳細については、ThreadPool のトピックを参照してください。

EntryWritten イベントをボタンなどのビジュアルな Windows フォーム コンポーネントで処理するとき、システム スレッド プールを通じてコンポーネントにアクセスすると、適切に動作しなかったり、例外が発生したりする場合があります。これを防ぐには、SynchronizingObject に Windows フォームのコンポーネントを設定して、コンポーネントが作成されているスレッドと同じスレッドで EntryWritten イベントを処理するメソッドが呼び出されるようにします。

Visual Studio 2005 内部の Windows フォーム デザイナで EventLog を使用すると、SynchronizingObject には EventLog が格納されているコントロールが自動的に設定されます。たとえば、EventLog を Form から継承される Form1 のデザイナに配置した場合、EventLog の SynchronizingObject プロパティには Form1 のインスタンスが設定されます。

.NET Framework のセキュリティ

• EventLogPermission  (コンピュータのイベント ログ情報の書き込み) EventLogPermissionAccess.Write (関連する列挙体)

プラットフォーム

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

参照

関連項目
EventLog クラス
EventLog メンバ
System.Diagnostics 名前空間
EntryWritten
ThreadPool