EventLog.SynchronizingObject Property
Assembly: System (in system.dll)
/** @property */ public ISynchronizeInvoke get_SynchronizingObject () /** @property */ public void set_SynchronizingObject (ISynchronizeInvoke value)
public function get SynchronizingObject () : ISynchronizeInvoke public function set SynchronizingObject (value : ISynchronizeInvoke)
Property Value
The ISynchronizeInvoke used to marshal event-handler calls issued as a result of an EntryWritten event on the event log. Note |
|---|
| The HostProtectionAttribute attribute applied to this property has the following Resources property value: Synchronization. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes. |
When SynchronizingObject is a null reference (Nothing in Visual Basic), methods handling the EntryWritten event are called on a thread from the system thread pool. For more information on system thread pools, see ThreadPool.
When the EntryWritten event is handled by a visual Windows Forms component, such as a button, accessing the component through the system thread pool might not work, or might result in an exception. Avoid this by setting SynchronizingObject to a Windows Forms component, which causes the methods handling the EntryWritten event to be called on the same thread on which the component was created.
If the EventLog is used inside Visual Studio 2005 in a Windows Forms designer, SynchronizingObject is automatically set to the control containing the EventLog. For example, if you place an EventLog on a designer for Form1 (which inherits from Form) the SynchronizingObject property of EventLog is set to the instance of Form1.
- EventLogPermission for writing the event log information on the computer. Associated enumeration: 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
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
Note