EventSource Constructor (String^, EventSourceSettings, array<String^>^)

.NET Framework (current version)
 

Creates a new instance of the EventSource class with the specified configuration settings.

Namespace:   System.Diagnostics.Tracing
Assembly:  mscorlib (in mscorlib.dll)

public:
EventSource(
	String^ eventSourceName,
	EventSourceSettings config,
	... array<String^>^ traits
)

Parameters

eventSourceName
Type: System::String^

The name to apply to the event source. Must not be null.

config
Type: System.Diagnostics.Tracing::EventSourceSettings

A bitwise combination of the enumeration values that specify the configuration settings to apply to the event source.

traits
Type: array<System::String^>^

The key-value pairs that specify traits for the event source.

Exception Condition
ArgumentNullException

eventSourceName is null.

ArgumentException

traits is not specified in key-value pairs.

Traits provide additional information for an event and are interpreted by an event listener. Traits are specified as key-value pairs and if not specified in pairs, an exception will occur. You can retrieve a trait by passing the key to the GetTrait, method.

Specifying config when the EventSource is constructed enables you to specify whether the event is written in a manifest-based or a self-describing format. In addition, you can specify that an exception should be raised when an error occurs during the event-writing process.

Universal Windows Platform
Available since 10
.NET Framework
Available since 4.6
Return to top
Show: