Edit

Share via


EventSourceSettings Enum

Definition

Specifies configuration options for an event source.

This enumeration supports a bitwise combination of its member values.

public enum class EventSourceSettings
[System.Flags]
public enum EventSourceSettings
[<System.Flags>]
type EventSourceSettings = 
Public Enum EventSourceSettings
Inheritance
EventSourceSettings
Attributes

Fields

Name Value Description
Default 0

None of the special configuration options are enabled.

ThrowOnEventWriteErrors 1

The event source throws an exception when an error occurs.

EtwManifestEventFormat 4

The ETW listener should use a manifest-based format when raising events. This is the default option when defining a type derived from EventSource using one of the protected EventSource constructors. This format has lower per-event serialization overhead compared to EtwSelfDescribingEventFormat. For more information, see Self-describing vs. manifest event formats.

EtwSelfDescribingEventFormat 8

The ETW listener should use self-describing event format. This is the default option when creating a new instance of the EventSource using one of the public EventSource constructors. This format has more capabilities and better compatibility with listeners that don't use the TraceEvent library, but has higher per-event serialization overhead compared to EtwManifestEventFormat. For more information, see Self-describing vs. manifest event formats.

Remarks

Only EtwManifestEventFormat or EtwSelfDescribingEventFormat should be specified, but not both.

Applies to