EventLogInstaller.Source Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Configuration.Install.dll

Ruft den im Protokoll zu registrierenden Namen der Quelle ab 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 im Ereignisprotokoll als Quelle für Einträge registriert werden soll. Der Standardwert ist eine leere Zeichenfolge ("").

Attribute

TypeConverterAttribute

Hinweise

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

Das Installationsprogramm verwendet den Wert der Source -Eigenschaft, um Ihre Anwendung beim 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. Beispielsweise erfordert Ihre Anwendung möglicherweise mehrere Quellen, 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 keinen Protokollnamen angeben, bevor das Installationsprogramm ausgeführt wird, registriert das Installationsprogramm Ihre Quelle im Anwendungsprotokoll. Wenn Sie den Namen eines Protokolls angeben, das nicht vorhanden ist, registriert das System das Source für dieses Protokoll, aber das Protokoll wird erst erstellt, wenn der erste Eintrag in dieses Protokoll geschrieben wurde.

Verwenden Sie EventLogInstaller , um eine neue Quelle für ein neues oder vorhandenes Ereignisprotokoll zu registrieren. 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 entsprechen. Die Install -Methode löst eine Ausnahme aus, wenn die Source Eigenschaft mit einem Quellnamen übereinstimmt, der 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 zum Verhalten von Ereignisprotokollen und -quellen finden Sie in der EventLog Klassendokumentation für die Log Eigenschaften und Source .

Weitere Informationen

• Source
• EventLog