EventLogInstaller.Log-Eigenschaft
Aktualisiert: November 2007
Ruft den Namen des Protokolls ab, für das die Quelle festgelegt werden soll, oder legt diesen fest.
Assembly: System.Configuration.Install (in System.Configuration.Install.dll)
[TypeConverterAttribute("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")] public string Log { get; set; }
/** @property */
/** @attribute TypeConverterAttribute("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") */
public String get_Log()
/** @property */
/** @attribute TypeConverterAttribute("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") */
public void set_Log(String value)
public function get Log () : String public function set Log (value : String)
Eigenschaftenwert
Typ: System.StringDer Name des Protokolls. Dabei kann es sich um einen Anwendungs-, einen System- oder einen benutzerdefinierten Protokollnamen handeln. Der Standardwert ist eine leere Zeichenfolge ("").
Mithilfe der Log-Eigenschaft können Sie die in der Source-Eigenschaft angegebene Quelle entweder einem bereits vorhandenen Protokoll oder einem neuen Protokoll auf dem lokalen Computer zuordnen. Anhand dieser Informationen ordnet Installer-Tool (Installutil.exe) die Quelle dem Protokoll in der Registrierung des Computers zu. Anwendungen und Dienste schreiben in das Anwendungsprotokoll oder ein benutzerdefiniertes Protokoll. Gerätetreiber schreiben i. d. R. in das Systemprotokoll.
Um Einträge in ein Ereignisprotokoll schreiben zu können, muss zuerst eine Quelle erstellt und für ein Ereignisprotokoll registriert werden. Eine Ereignisquelle kann nur in ein Protokoll gleichzeitig schreiben. Das Installationsprogramm registriert mithilfe des Werts der Source-Eigenschaft die Anwendung im Ereignisprotokoll als gültige Quelle für Einträge. Wenn Sie vor dem Ausführen des Installationsprogramms keinen Protokollnamen angeben, registriert das Installationsprogramm die Quelle im Anwendungsprotokoll. Wenn Sie eine neue Quelle und ein bereits vorhandenes Protokoll angeben, erstellt das Installationsprogramm eine neue Ereignisquelle und ordnet diese dem von Ihnen angegebenen Protokoll zu. Wenn Sie sowohl eine neue Quelle als auch ein neues Protokoll angeben, ordnet das Installationsprogramm die neue Quelle dem neuen Protokoll in der Registrierung zu. Das Protokoll wird jedoch erst erstellt, wenn der erste Eintrag in dieses geschrieben wird.
Das Betriebssystem speichert Ereignisprotokolle als Dateien. Wenn Sie ein neues Ereignisprotokoll mit EventLogInstaller oder der CreateEventSource-Methode erstellen, wird die zugeordnete Datei auf dem angegebenen Computer im Verzeichnis %SystemRoot%\System32\Config gespeichert. Der Dateiname setzt sich aus den ersten acht Zeichen der Log-Eigenschaft und der Dateinamenerweiterung ".evt" zusammen.
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.
- 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 Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
