EventSourceCreationData.Source Eigenschaft

Definition

Namespace:
System.Diagnostics
Assembly:
System.dll

Ruft den Namen ab, der mit dem Ereignisprotokoll als Ereignisquelle registriert werden soll, oder legt diesen fest.

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

Eigenschaftswert

String

Der Name, der beim Ereignisprotokoll als Quelle von Einträgen registriert werden soll. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Im folgenden Codebeispiel werden die Konfigurationseigenschaften für eine Ereignisquelle aus Befehlszeilenargumenten festgelegt. Die Eingabeargumente geben den Namen der Ereignisquelle, den Namen des Ereignisprotokolls, den Computernamen und die Ressourcendatei für Ereignisnachrichten an. Dieses Beispiel ist Teil eines größeren Beispiels, das für die EventSourceCreationData Klasse bereitgestellt wird.

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

Hinweise

Der Quellname ist häufig der Name der Anwendung oder der Name einer Komponente innerhalb einer großen Anwendung. Die EventLog.CreateEventSource(EventSourceCreationData) Methode verwendet die SourceRegistrierungswerte LogNameund MachineName Eigenschaften zum Erstellen von Registrierungswerten auf dem Zielcomputer für die neue Quelle und das zugehörige Ereignisprotokoll. Ein neuer Quellname kann nicht mit einem vorhandenen Quellnamen oder einem vorhandenen Ereignisprotokollnamen auf dem Zielcomputer übereinstimmen.

Nachdem die Registrierungswerte für die Quelle erstellt wurden, kann Ihre Anwendung die Quelle verwenden, um Einträge in das konfigurierte Ereignisprotokoll zu schreiben.

Jede Quelle kann jeweils nur in ein Ereignisprotokoll schreiben; Ihre Anwendung kann jedoch mehrere Quellen verwenden, um in mehrere Ereignisprotokolle zu schreiben. Ihre Anwendung kann z. B. mehrere Quellen erfordern, die für unterschiedliche Ereignisprotokolle oder unterschiedliche Ressourcendateien konfiguriert sind.

Gilt für:

Weitere Informationen