EventSourceCreationData.Source Property


Gets or sets the name to register with the event log as an event source.

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

Public Property Source As String

Property Value

Type: System.String

The name to register with the event log as a source of entries. The default is an empty string ("").

The source name is often the name of the application, or the name of a component within a large application. The EventLog.CreateEventSource(EventSourceCreationData) method uses the Source, LogName, and MachineName properties to create registry values on the target computer for the new source and its associated event log. A new source name cannot match an existing source name or an existing event log name on the target computer.

After the registry values for the source are created, your application can use the source to write entries to the configured event log.

Each source can only write to one event log at a time; however, your application can use multiple sources to write to multiple event logs. For example, your application might require multiple sources configured for different event logs or different resource files.

The following code example sets the configuration properties for an event source from command-line arguments. The input arguments specify the event source name, event log name, computer name, and event message resource file. This example is part of a larger example provided for the EventSourceCreationData class.

Dim mySourceData As EventSourceCreationData = new EventSourceCreationData("", "")
Dim registerSource As Boolean = True

' Process input parameters.
If args.Length > 0
    ' Require at least the source name.

    mySourceData.Source = args(0)

    If args.Length > 1

        mySourceData.LogName = args(1)

    End If
    If args.Length > 2

        mySourceData.MachineName = args(2)

    End If
    If args.Length > 3 AndAlso args(3).Length > 0

        mySourceData.MessageResourceFile = args(3)

    End If

    ' Display a syntax help message.
    Console.WriteLine(" source [event log] [machine name] [resource file]")

    registerSource = False
End If

' Set defaults for parameters missing input.
If mySourceData.MachineName.Length = 0

    ' Default to the local computer.
    mySourceData.MachineName = "."
End If
If mySourceData.LogName.Length = 0
    ' Default to the Application log.
    mySourceData.LogName = "Application"
End If


for calling any member of EventSourceCreationData with full trust. Associated enumeration: PermissionState.Unrestricted

.NET Framework
Available since 2.0
Return to top