EventLog.SynchronizingObject Свойство

Определение

Возвращает или задает объект, используемый для маршалинга вызовов обработчика событий, возникающих в результате события записи в EventLog.Gets or sets the object used to marshal the event handler calls issued as a result of an EventLog entry written event.

public:
 property System::ComponentModel::ISynchronizeInvoke ^ SynchronizingObject { System::ComponentModel::ISynchronizeInvoke ^ get(); void set(System::ComponentModel::ISynchronizeInvoke ^ value); };
[System.ComponentModel.Browsable(false)]
public System.ComponentModel.ISynchronizeInvoke SynchronizingObject { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.SynchronizingObject : System.ComponentModel.ISynchronizeInvoke with get, set
Public Property SynchronizingObject As ISynchronizeInvoke

Значение свойства

ISynchronizeInvoke

Объект ISynchronizeInvoke, используемый для маршалинга вызовов обработчика событий, возникающих в результате события записи EntryWritten в журнал событий.The ISynchronizeInvoke used to marshal event-handler calls issued as a result of an EntryWritten event on the event log.

Атрибуты

Комментарии

Если SynchronizingObject имеет значение null , методы, обрабатывающие EntryWritten событие, вызываются в потоке из пула системных потоков.When SynchronizingObject is null, methods handling the EntryWritten event are called on a thread from the system thread pool. Дополнительные сведения о пулах системных потоков см. в разделе ThreadPool .For more information on system thread pools, see ThreadPool.

Если EntryWritten событие обрабатывается компонентом visual Windows Forms, например кнопкой, доступ к компоненту через пул системных потоков может не работать или может привести к исключению.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. Это следует избегать, если задать SynchronizingObject компоненту Windows Forms, в результате чего методы, обрабатывающие EntryWritten событие, вызываются в том же потоке, в котором был создан компонент.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.

Если EventLog используется внутри Visual Studio 2005Visual Studio 2005 в конструкторе Windows Forms, SynchronizingObject автоматически задается элемент управления, содержащий EventLog .If the EventLog is used inside Visual Studio 2005Visual Studio 2005 in a Windows Forms designer, SynchronizingObject is automatically set to the control containing the EventLog. Например, при помещении EventLog в конструктор для Form1 (который наследуется от Form ) SynchronizingObject свойство объекта EventLog задается экземпляром Form1.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.

Применяется к

См. также раздел