EventLogInstaller Klasa

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Configuration.Install.dll

Umożliwia zainstalowanie i skonfigurowanie dziennika zdarzeń, z którego aplikacja odczytuje dane z aplikacji lub zapisuje je podczas uruchamiania.

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

Dziedziczenie

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

EventLogInstaller

Przykłady

Poniższy przykład kodu ustawia właściwości instalacji dla nowego źródła zdarzeń. Przykładowy kod ustawia nazwę źródła i nazwę dziennika zdarzeń oraz dodaje element EventLogInstaller do kolekcji Installers .

#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

Uwagi

Element EventLogInstaller jest używany przez Installutil.exe (narzędzie instalatora) podczas instalowania dziennika zdarzeń. Klasa EventLogInstaller może instalować dzienniki zdarzeń tylko na komputerze lokalnym.

EventLogInstaller Użyj klasy , gdy aplikacja zapisuje w dzienniku zdarzeń. Nie jest konieczne użycie instalatora dziennika zdarzeń dla aplikacji do odczytu z dziennika zdarzeń. Aplikacje i usługi powinny zapisywać w dzienniku aplikacji lub dzienniku niestandardowym. Sterowniki urządzeń powinny zapisywać w dzienniku systemu.

Uwaga

Dziennik zabezpieczeń jest tylko do odczytu.

Instalator tworzy źródło zdarzeń określone we Source właściwości i rejestruje je dla dziennika zdarzeń określonego we Log właściwości. To zachowanie jest podobne do wywoływania CreateEventSourceEventLog składnika.

WriteEvent Użyj metod i WriteEntry do zapisywania zdarzeń w dzienniku zdarzeń. Należy określić źródło zdarzeń do zapisywania zdarzeń; przed zapisaniem pierwszego wpisu ze źródłem należy utworzyć i skonfigurować źródło zdarzeń.

Utwórz nowe źródło zdarzeń podczas instalacji aplikacji. Dzięki temu system operacyjny może odświeżyć listę zarejestrowanych źródeł zdarzeń i ich konfiguracji. Jeśli system operacyjny nie odświeżył listy źródeł zdarzeń i spróbujesz zapisać zdarzenie z nowym źródłem, operacja zapisu zakończy się niepowodzeniem. Nowe źródło można skonfigurować przy użyciu metody EventLogInstallerlub CreateEventSource metody . Aby utworzyć nowe źródło zdarzeń, musisz mieć uprawnienia administracyjne na komputerze.

Możesz utworzyć źródło zdarzeń dla istniejącego dziennika zdarzeń lub nowego dziennika zdarzeń. Podczas tworzenia nowego źródła dla nowego dziennika zdarzeń system rejestruje źródło dla tego dziennika, ale dziennik nie jest tworzony, dopóki pierwszy wpis nie zostanie do niego zapisany.

Aby zainstalować dziennik zdarzeń, utwórz klasę instalatora projektu, która dziedziczy z Installerklasy , i ustaw dla RunInstallerAttribute klasy wartość true. W projekcie utwórz dla EventLogInstaller każdego dziennika zdarzeń, do którego aplikacja zapisze wystąpienie, i dodaj je do klasy instalatora projektu.

Gdy zostanie wywołana Installutil.exe (narzędzie instalatora), przyjrzy się .RunInstallerAttribute Jeśli jest trueto , narzędzie instaluje wszystkie elementy w Installers kolekcji skojarzone z instalatorem projektu. Jeśli RunInstallerAttribute parametr ma falsewartość , narzędzie ignoruje instalatora projektu.

Zmodyfikujesz inne właściwości EventLogInstaller elementu przed lub po dodaniu wystąpienia do Installers kolekcji instalatora projektu, ale przed uruchomieniem narzędzia instalatora. Należy ustawić Source właściwość , jeśli aplikacja będzie zapisywać w dzienniku zdarzeń.

Użyj EventLogInstaller polecenia , aby zarejestrować nowe źródło dla nowego lub istniejącego dziennika zdarzeń; nie należy używać EventLogInstaller go do zmiany istniejącego źródła. Klasa EventLogInstaller nie modyfikuje właściwości konfiguracji istniejącego źródła, aby odpowiadała określonym właściwościom instalacji. Metoda Install zgłasza wyjątek, jeśli Source właściwość jest zgodna z nazwą źródłową zarejestrowaną dla innego dziennika zdarzeń na komputerze. Metoda Install nie rejestruje źródła, jeśli Source właściwość jest zgodna z nazwą źródłową, która jest już zarejestrowana dla tego samego dziennika zdarzeń określonego Log we właściwości.

Źródło zdarzeń można zarejestrować za pomocą zlokalizowanych plików zasobów dla kategorii zdarzeń i ciągów komunikatów. Aplikacja może zapisywać wpisy dziennika zdarzeń przy użyciu identyfikatorów zasobów, zamiast określać rzeczywisty ciąg. Podgląd zdarzeń używa identyfikatora zasobu do znajdowania i wyświetlania odpowiedniego ciągu z zlokalizowanego pliku zasobów na podstawie bieżących ustawień języka. Możesz zarejestrować oddzielny plik dla kategorii zdarzeń, komunikatów i ciągów wstawiania parametrów lub zarejestrować ten sam plik zasobów dla wszystkich trzech typów ciągów. CategoryCountUżyj właściwości , , MessageResourceFileCategoryResourceFilei ParameterResourceFile , aby skonfigurować źródło do zapisywania zlokalizowanych wpisów w dzienniku zdarzeń. Jeśli aplikacja zapisuje wartości ciągów bezpośrednio w dzienniku zdarzeń, nie trzeba ustawiać tych właściwości.

Źródło musi być skonfigurowane do zapisywania zlokalizowanych wpisów lub zapisywania ciągów bezpośrednich. Jeśli aplikacja zapisuje wpisy przy użyciu identyfikatorów zasobów i wartości ciągów, musisz zarejestrować dwa oddzielne źródła. Na przykład skonfiguruj jedno źródło z plikami zasobów, a następnie użyj tego źródła w WriteEvent metodzie , aby zapisać wpisy przy użyciu identyfikatorów zasobów w dzienniku zdarzeń. Utwórz inne źródło bez plików zasobów, a następnie użyj tego źródła w metodzie WriteEntry , aby zapisywać ciągi bezpośrednio w dzienniku zdarzeń przy użyciu tego źródła.

Zazwyczaj metody klasy nie są wywoływane EventLogInstaller z poziomu kodu; są one zwykle wywoływane tylko przez Installutil.exe. Narzędzie automatycznie wywołuje metodę Install podczas procesu instalacji. W razie potrzeby usuwa błędy, wywołując metodę Rollback dla obiektu, który wygenerował wyjątek.

Konstruktory

EventLogInstaller()

Inicjuje nowe wystąpienie klasy EventLogInstaller.

Właściwości

CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
CategoryCount	Pobiera lub ustawia liczbę kategorii w pliku zasobu kategorii.
CategoryResourceFile	Pobiera lub ustawia ścieżkę pliku zasobu zawierającego ciągi kategorii dla źródła.
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
Context	Pobiera lub ustawia informacje o bieżącej instalacji. (Odziedziczone po Installer)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
HelpText	Pobiera tekst pomocy dla wszystkich instalatorów w kolekcji instalatora. (Odziedziczone po Installer)
Installers	Pobiera kolekcję instalatorów, które zawiera ten instalator. (Odziedziczone po Installer)
Log	Pobiera lub ustawia nazwę dziennika, aby ustawić źródło na .
MessageResourceFile	Pobiera lub ustawia ścieżkę pliku zasobu zawierającego ciągi formatowania komunikatów dla źródła.
ParameterResourceFile	Pobiera lub ustawia ścieżkę pliku zasobu zawierającego ciągi parametrów komunikatu dla źródła.
Parent	Pobiera lub ustawia instalator zawierający kolekcję, do których należy ten instalator. (Odziedziczone po Installer)
Site	Pobiera lub ustawia wartość ISite .Component (Odziedziczone po Component)
Source	Pobiera lub ustawia nazwę źródła do zarejestrowania w dzienniku.
UninstallAction	Pobiera lub ustawia wartość wskazującą, czy Installutil.exe (narzędzie instalatora) powinien usunąć dziennik zdarzeń lub pozostawić go w stanie zainstalowanym w czasie odinstalowywania.

Metody

Commit(IDictionary)	Po zastąpieniu w klasie pochodnej, kończy transakcję instalacji. (Odziedziczone po Installer)
CopyFromComponent(IComponent)	Kopiuje wartości EventLog właściwości składnika, który jest wymagany w czasie instalacji dla dziennika zdarzeń.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container. (Odziedziczone po Component)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
Install(IDictionary)	Wykonuje instalację i zapisuje informacje dziennika zdarzeń w rejestrze.
IsEquivalentInstaller(ComponentInstaller)	Określa, czy instalator i inny określony instalator odwołują się do tego samego źródła.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnAfterInstall(IDictionary)	AfterInstall Zgłasza zdarzenie. (Odziedziczone po Installer)
OnAfterRollback(IDictionary)	AfterRollback Zgłasza zdarzenie. (Odziedziczone po Installer)
OnAfterUninstall(IDictionary)	AfterUninstall Zgłasza zdarzenie. (Odziedziczone po Installer)
OnBeforeInstall(IDictionary)	BeforeInstall Zgłasza zdarzenie. (Odziedziczone po Installer)
OnBeforeRollback(IDictionary)	BeforeRollback Zgłasza zdarzenie. (Odziedziczone po Installer)
OnBeforeUninstall(IDictionary)	BeforeUninstall Zgłasza zdarzenie. (Odziedziczone po Installer)
OnCommitted(IDictionary)	Committed Zgłasza zdarzenie. (Odziedziczone po Installer)
OnCommitting(IDictionary)	Committing Zgłasza zdarzenie. (Odziedziczone po Installer)
Rollback(IDictionary)	Przywraca komputer do stanu, w jaki znajdował się przed instalacją, cofając informacje dziennika zdarzeń, które zostały napisane w rejestrze przez procedurę instalacji.
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)
Uninstall(IDictionary)	Usuwa instalację przez usunięcie informacji dziennika zdarzeń z rejestru.

Zdarzenia

AfterInstall	Występuje po uruchomieniu Install(IDictionary) metod wszystkich instalatorów we Installers właściwości . (Odziedziczone po Installer)
AfterRollback	Występuje po wycofaniu instalacji wszystkich instalatorów we Installers właściwości. (Odziedziczone po Installer)
AfterUninstall	Występuje po wykonaniu Installers operacji dezinstalacji przez wszystkich instalatorów we właściwości. (Odziedziczone po Installer)
BeforeInstall	Występuje przed uruchomieniem Install(IDictionary) metody każdego instalatora w kolekcji instalatora. (Odziedziczone po Installer)
BeforeRollback	Występuje przed wycofaniem instalatorów we Installers właściwości. (Odziedziczone po Installer)
BeforeUninstall	Występuje przed wykonaniem operacji dezinstalacji przez instalatorów we Installers właściwości. (Odziedziczone po Installer)
Committed	Występuje po zatwierdzeniu instalacji przez wszystkich instalatorów we Installers właściwości. (Odziedziczone po Installer)
Committing	Występuje przed zatwierdzeniem instalacji przez instalatorów we Installers właściwości. (Odziedziczone po Installer)
Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)

Zobacz też

• EventLog
• CreateEventSource
• Installutil.exe (narzędzie instalatora)