EventLogInstaller.Source Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Configuration.Install.dll

Ruft den Quellnamen ab, der beim Protokoll registriert werden soll, oder legt diesen fest.

public:
 property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
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 ("").

Attribute

TypeConverterAttribute

Hinweise

Die Ereignisquelle gibt an, was das Ereignis protokolliert. Es ist häufig der Name der Anwendung oder der Name einer Komponente innerhalb einer großen Anwendung.

Das Installationsprogramm verwendet den Wert der Source Eigenschaft, um Ihre Anwendung mit dem Ereignisprotokoll als gültige Quelle von Einträgen zu registrieren. Ein neuer Quellname kann nicht mit einem vorhandenen Quellnamen oder einem vorhandenen Ereignisprotokollnamen übereinstimmen. 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.

Anwendungen und Dienste sollten in das Anwendungsprotokoll oder ein benutzerdefiniertes Protokoll schreiben. Gerätetreiber sollten in das Systemprotokoll schreiben. Wenn Sie vor der Ausführung des Installers keinen Protokollnamen angeben, registriert das Installationsprogramm Ihre Quelle im Anwendungsprotokoll. Wenn Sie den Namen eines nicht vorhandenen Protokolls angeben, registriert das System das Source Protokoll für dieses Protokoll, aber das Protokoll wird erst erstellt, wenn der erste Eintrag in das Protokoll geschrieben wird.

Dient EventLogInstaller zum Registrieren einer neuen Quelle für ein neues oder vorhandenes Ereignisprotokoll; verwenden EventLogInstaller Sie nicht, um eine vorhandene Quelle zu ändern. Die EventLogInstaller Klasse ändert die Konfigurationseigenschaften einer vorhandenen Quelle nicht so, dass sie den angegebenen Installationseigenschaften entspricht. Die Install Methode löst eine Ausnahme aus, wenn die Eigenschaft mit einem Quellnamen übereinstimmt, der Source für ein anderes Ereignisprotokoll auf dem Computer registriert ist. Die Install Methode registriert die Quelle nicht, wenn die Source Eigenschaft mit einem Quellnamen übereinstimmt, der bereits für dasselbe Ereignisprotokoll registriert ist, das in der Log Eigenschaft angegeben ist.

Ausführlichere Informationen über das Verhalten von Ereignisprotokollen und -quellen finden Sie in der EventLog Klassendokumentation für die und Source die Log Eigenschaften.

Weitere Informationen

• Source
• EventLog