EventSourceCreationData.Source Egenskap

Definition

Hämtar eller anger namnet som ska registreras med händelseloggen som händelsekälla.

public:
 property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };
public string? Source { get; set; }
public string Source { get; set; }
member this.Source : string with get, set
Public Property Source As String

Egenskapsvärde

Namnet som ska registreras med händelseloggen som källa för poster. Standardvärdet är en tom sträng ("").

Exempel

I följande kodexempel anges konfigurationsegenskaperna för en händelsekälla från kommandoradsargument. Indataargumenten anger händelsekällans namn, händelseloggnamn, datornamn och resursfil för händelsemeddelande. Det här exemplet är en del av ett större exempel som tillhandahålls EventSourceCreationData för klassen.

EventSourceCreationData mySourceData = new EventSourceCreationData("", "");
bool registerSource = 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];
    }

    if (args.Length > 2)
    {
        mySourceData.MachineName = args[2];
    }
    if ((args.Length > 3) && (args[3].Length > 0))
    {
        mySourceData.MessageResourceFile = args[3];
    }
}
else
{
    // Display a syntax help message.
    Console.WriteLine("Input:");
    Console.WriteLine(" source [event log] [machine name] [resource file]");

    registerSource = false;
}

// Set defaults for parameters missing input.
if (mySourceData.MachineName.Length == 0)
{
    // Default to the local computer.
    mySourceData.MachineName = ".";
}
if (mySourceData.LogName.Length == 0)
{
    // Default to the Application log.
    mySourceData.LogName = "Application";
}
         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

         Else 
             ' Display a syntax help message.
             Console.WriteLine("Input:")
             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

Kommentarer

Källnamnet är ofta namnet på programmet eller namnet på en komponent i ett stort program. Metoden EventLog.CreateEventSource(EventSourceCreationData) använder Sourceegenskaperna , LogNameoch MachineName för att skapa registervärden på måldatorn för den nya källan och dess associerade händelselogg. Ett nytt källnamn kan inte matcha ett befintligt källnamn eller ett befintligt händelseloggnamn på måldatorn.

När registervärdena för källan har skapats kan programmet använda källan för att skriva poster till den konfigurerade händelseloggen.

Varje källa kan bara skriva till en händelselogg i taget. Ditt program kan dock använda flera källor för att skriva till flera händelseloggar. Ditt program kan till exempel kräva flera källor som konfigurerats för olika händelseloggar eller olika resursfiler.

Gäller för

Se även