EventLogInstaller.Source-Eigenschaft

Ruft den im Protokoll zu registrierenden Namen der Quelle ab oder legt diesen fest.

Namespace: System.Diagnostics
Assembly: System.Configuration.Install (in system.configuration.install.dll)

Syntax

'Declaration
Public Property Source As String
'Usage
Dim instance As EventLogInstaller
Dim value As String

value = instance.Source

instance.Source = value

public string Source { get; set; }

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

/** @property */
public String get_Source ()

/** @property */
public void set_Source (String value)

public function get Source () : String

public function set Source (value : String)

Eigenschaftenwert

Der Name, der im Ereignisprotokoll als Quelle für Einträge registriert werden soll. Der Standardwert ist eine leere Zeichenfolge ("").

Hinweise

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

Das Installationsprogramm registriert mithilfe der Source-Eigenschaft die Anwendung im Ereignisprotokoll als gültige Quelle für Einträge. Ein neuer Quellname darf nicht mit einem vorhandenen Quellnamen oder einem vorhandenen Ereignisprotokollnamen übereinstimmen. Die einzelnen Quellen können immer nur in je ein Ereignisprotokoll schreiben. Die Anwendung kann jedoch mehrere Quellen verwenden, um in mehrere Ereignisprotokolle zu schreiben. Beispielsweise müssen für die Anwendung eventuell mehrere Quellen für unterschiedliche Ereignisprotokolle oder Ressourcendateien konfiguriert werden.

Anwendungen und Dienste schreiben in das Anwendungsprotokoll oder ein benutzerdefiniertes Protokoll. Gerätetreiber schreiben i. d. R. in das Systemprotokoll. Wenn Sie vor dem Ausführen des Installationsprogramms keinen Protokollnamen angeben, registriert das Installationsprogramm die Quelle im Anwendungsprotokoll. Wenn Sie den Namen eines nicht vorhandenen Protokolls angeben, registriert das System die Source in diesem Protokoll. Das Protokoll wird jedoch erst erstellt, wenn der erste Eintrag in dieses geschrieben wird.

Verwenden Sie EventLogInstaller zum Registrieren einer neuen Quelle für ein neues oder vorhandenes Ereignisprotokoll. EventLogInstaller darf nicht zum Ändern einer vorhandenen Quelle verwendet werden. Mit der EventLogInstaller-Klasse werden die Konfigurationseigenschaften einer vorhandenen Quelle nicht an die angegebenen Installationseigenschaften angepasst. 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 Quelle wird von der Install-Methode nicht registriert, wenn die Source-Eigenschaft mit einem Quellnamen identisch ist, der bereits für das gleiche, in der Log-Eigenschaft angegebene Ereignisprotokoll registriert ist.

Weitere Informationen zum Verhalten von Ereignisprotokollen und -quellen finden Sie in der Dokumentation der EventLog-Klasse für die Log-Eigenschaft und die Source-Eigenschaft.

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

EventLogInstaller-Klasse
EventLogInstaller-Member
System.Diagnostics-Namespace
EventLog.Source-Eigenschaft
EventLog-Klasse