EventLogInstaller Klasse

Definition

public ref class EventLogInstaller : System::Configuration::Install::ComponentInstaller

public class EventLogInstaller : System.Configuration.Install.ComponentInstaller

type EventLogInstaller = class
    inherit ComponentInstaller

Public Class EventLogInstaller
Inherits ComponentInstaller

Vererbung

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

EventLogInstaller

Beispiele

Im folgenden Codebeispiel werden die Installationseigenschaften für eine neue Ereignisquelle festgelegt. Im Codebeispiel werden der Quellname und der Ereignisprotokollname festgelegt und der EventLogInstallerInstallers Auflistung hinzugefügt.

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Configuration::Install;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

[RunInstaller(true)]
ref class MyEventLogInstaller: public Installer
{
private:
   EventLogInstaller^ myEventLogInstaller;

public:
   MyEventLogInstaller()
   {
      // Create an instance of an EventLogInstaller.
      myEventLogInstaller = gcnew EventLogInstaller;

      // Set the source name of the event log.
      myEventLogInstaller->Source = "NewLogSource";
         
      // Set the event log that the source writes entries to.
      myEventLogInstaller->Log = "MyNewLog";
         
      // Add myEventLogInstaller to the Installer collection.
      Installers->Add( myEventLogInstaller );
   }
};

using System;
using System.Configuration.Install;
using System.Diagnostics;
using System.ComponentModel;

[RunInstaller(true)]
public class MyEventLogInstaller: Installer
{
    private EventLogInstaller myEventLogInstaller;

    public MyEventLogInstaller()
    {
        // Create an instance of an EventLogInstaller.
        myEventLogInstaller = new EventLogInstaller();

        // Set the source name of the event log.
        myEventLogInstaller.Source = "NewLogSource";

        // Set the event log that the source writes entries to.
        myEventLogInstaller.Log = "MyNewLog";

        // Add myEventLogInstaller to the Installer collection.
        Installers.Add(myEventLogInstaller);
    }

    public static void Main()
    {
        MyEventLogInstaller myInstaller = new MyEventLogInstaller();
    }
}

   Imports System.Configuration.Install
Imports System.Diagnostics
Imports System.ComponentModel

<RunInstaller(True)>  _
Public Class MyEventLogInstaller
   Inherits Installer
   Private myEventLogInstaller As EventLogInstaller
   
   Public Sub New()

      ' Create an instance of an EventLogInstaller.
      myEventLogInstaller = New EventLogInstaller()

      ' Set the source name of the event log.
      myEventLogInstaller.Source = "NewLogSource"

      ' Set the event log that the source writes entries to.
      myEventLogInstaller.Log = "MyNewLog"

      ' Add myEventLogInstaller to the Installer collection.
      Installers.Add(myEventLogInstaller)
   End Sub

 Public Shared Sub Main()
 End Sub
 Dim myInstaller As New EventLogInstaller()
End Class

Hinweise

Wird EventLogInstaller vom Installutil.exe (Installationstool) beim Installieren eines Ereignisprotokolls verwendet. Die EventLogInstaller -Klasse kann Ereignisprotokolle nur auf dem lokalen Computer installieren.

Verwenden Sie die EventLogInstaller -Klasse, wenn Ihre Anwendung in ein Ereignisprotokoll schreibt. Es ist nicht erforderlich, ein Ereignisprotokollinstallationsprogramm zu verwenden, damit Ihre Anwendung aus einem Ereignisprotokoll lesen kann. Anwendungen und Dienste sollten in das Anwendungsprotokoll oder ein benutzerdefiniertes Protokoll schreiben. Gerätetreiber sollten in das Systemprotokoll schreiben.

Das Installationsprogramm erstellt die Ereignisquelle, die Sie in der Source -Eigenschaft angeben, und registriert sie für das in Log der -Eigenschaft angegebene Ereignisprotokoll. Dieses Verhalten ähnelt dem Aufrufen CreateEventSource der EventLog Komponente.

Verwenden Sie die WriteEvent Methoden und WriteEntry , um Ereignisse in ein Ereignisprotokoll zu schreiben. Sie müssen eine Ereignisquelle angeben, um Ereignisse zu schreiben. Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben.

Erstellen Sie die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfigurationen aktualisieren. Wenn das Betriebssystem seine Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mit oder EventLogInstallermit der CreateEventSource -Methode konfigurieren. Sie müssen über Administratorrechte auf dem Computer verfügen, um eine neue Ereignisquelle zu erstellen.

Sie können eine Ereignisquelle für ein vorhandenes Ereignisprotokoll oder ein neues Ereignisprotokoll erstellen. Wenn Sie eine neue Quelle für ein neues Ereignisprotokoll erstellen, registriert das System die Quelle für dieses Protokoll, aber das Protokoll wird erst erstellt, wenn der erste Eintrag in das Protokoll geschrieben wurde.

Um ein Ereignisprotokoll zu installieren, erstellen Sie eine Projektinstallationsprogrammklasse, die von Installererbt, und legen Sie für RunInstallerAttribute die -Klasse auf truefest. Erstellen Sie innerhalb Ihres Projekts für EventLogInstaller jedes Ereignisprotokoll, in das Ihre Anwendung schreibt, und fügen Sie die Instanz ihrer Projektinstallationsprogrammklasse hinzu.

Wenn das Installutil.exe (Installer-Tool) aufgerufen wird, wird die RunInstallerAttributeangezeigt. Wenn dies der Wert ist true, installiert das Tool alle Elemente in der Auflistung, die Installers Ihrem Projektinstallationsprogramm zugeordnet sind. Wenn RunInstallerAttribute dies der Wert ist false, ignoriert das Tool das Projektinstallationsprogramm.

Sie ändern andere Eigenschaften eines EventLogInstaller entweder vor oder nach dem Hinzufügen der Instanz zur Installers Auflistung Ihres Projektinstallationsprogramms, aber bevor das Installationstool ausgeführt wird. Sie müssen die Source -Eigenschaft festlegen, wenn Ihre Anwendung in das Ereignisprotokoll schreibt.

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.

Sie können die Ereignisquelle mit lokalisierten Ressourcendateien für Ihre Ereigniskategorie und Nachrichtenzeichenfolgen registrieren. Ihre Anwendung kann Ereignisprotokolleinträge mithilfe von Ressourcenbezeichnern schreiben, anstatt die tatsächliche Zeichenfolge anzugeben. Die Ereignisanzeige verwendet den Ressourcenbezeichner, um die entsprechende Zeichenfolge aus der lokalisierten Ressourcendatei basierend auf den aktuellen Spracheinstellungen zu suchen und anzuzeigen. Sie können eine separate Datei für Ereigniskategorien, Nachrichten und Parametereinfügungszeichenfolgen registrieren, oder Sie können dieselbe Ressourcendatei für alle drei Typen von Zeichenfolgen registrieren. Verwenden Sie die CategoryCountEigenschaften , CategoryResourceFile, MessageResourceFileund ParameterResourceFile , um die Quelle zum Schreiben lokalisierter Einträge in das Ereignisprotokoll zu konfigurieren. Wenn Ihre Anwendung Zeichenfolgenwerte direkt in das Ereignisprotokoll schreibt, müssen Sie diese Eigenschaften nicht festlegen.

Die Quelle muss entweder für das Schreiben lokalisierter Einträge oder für das Schreiben direkter Zeichenfolgen konfiguriert werden. Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie eine andere Quelle ohne Ressourcendateien, und verwenden Sie dann diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

In der Regel rufen Sie die Methoden der -Klasse nicht in Ihrem Code auf. Sie werden in der EventLogInstaller Regel nur von Installutil.exe aufgerufen. Das Tool ruft die Install -Methode während des Installationsvorgangs automatisch auf. Fehler werden bei Bedarf durch Aufrufen der -Methode für das Rollback -Objekt, das die Ausnahme generiert hat, gesichert.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• EventLog
• CreateEventSource
• Installutil.exe (Installer-Tool)