EventLogInstaller Klasa

Definicja

Umożliwia zainstalowanie i skonfigurowanie dziennika zdarzeń, z którego aplikacja odczytuje lub zapisuje dane podczas uruchamiania.Allows you to install and configure an event log that your application reads from or writes to when running.

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

Przykłady

Poniższy przykład kodu ustawia właściwości instalacji dla nowego źródła zdarzenia.The following code example sets the installation properties for a new event source. Przykładowy kod ustawia nazwę źródła i nazwę dziennika zdarzeń i dodaje EventLogInstaller do Installers kolekcji.The code example sets the source name and the event log name, and adds the EventLogInstaller to the Installers collection.

#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

EventLogInstallerJest używany przez Installutil.exe (Narzędzie instalatora) podczas instalacji dziennika zdarzeń.The EventLogInstaller is used by the Installutil.exe (Installer Tool) when installing an event log. EventLogInstallerKlasa może instalować dzienniki zdarzeń tylko na komputerze lokalnym.The EventLogInstaller class can install event logs only on the local computer.

Użyj EventLogInstaller klasy, gdy aplikacja zapisuje dane w dzienniku zdarzeń; nie jest konieczne używanie Instalatora dziennika zdarzeń dla aplikacji do odczytu z dziennika zdarzeń.Use the EventLogInstaller class when your application writes to an event log; it is not necessary to use an event log installer for your application to read from an event log. Aplikacje i usługi powinny zapisywać w dzienniku aplikacji lub dzienniku niestandardowym.Applications and services should write to the Application log or a custom log. Sterowniki urządzeń powinny zapisywać dane w dzienniku systemu.Device drivers should write to the System log.

Uwaga

Dziennik zabezpieczeń jest tylko do odczytu.The Security log is read-only.

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.The installer creates the event source that you specify in the Source property and registers it for the event log specified in Log property. Takie zachowanie jest podobne do wywoływania CreateEventSource na EventLog składniku.This behavior is similar to calling CreateEventSource on the EventLog component.

Za pomocą WriteEvent WriteEntry metod i Zapisz zdarzenia w dzienniku zdarzeń.Use the WriteEvent and WriteEntry methods to write events to an event log. Należy określić źródło zdarzenia do zapisywania zdarzeń; przed zapisaniem pierwszego wpisu ze źródłem należy utworzyć i skonfigurować źródło zdarzenia.You must specify an event source to write events; you must create and configure the event source before writing the first entry with the source.

Utwórz nowe źródło zdarzenia podczas instalacji aplikacji.Create the new event source during the installation of your application. Pozwala to czas na odświeżenie listy zarejestrowanych źródeł zdarzeń i ich konfiguracji przez system operacyjny.This allows time for the operating system to refresh its list of registered event sources and their configurations. Jeśli system operacyjny nie odświeżył swojej listy źródeł zdarzeń i podjęto próbę zapisania zdarzenia z nowym źródłem, operacja zapisu zakończy się niepowodzeniem.If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. Nowe źródło można skonfigurować przy użyciu EventLogInstaller lub przy użyciu CreateEventSource metody.You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. Aby utworzyć nowe źródło zdarzeń, musisz mieć uprawnienia administracyjne na komputerze.You must have administrative rights on the computer to create a new event source.

Można utworzyć źródło zdarzenia dla istniejącego dziennika zdarzeń lub nowego dziennika zdarzeń.You can create an event source for an existing event log or a new event log. Gdy tworzysz nowe źródło dla nowego dziennika zdarzeń, system rejestruje źródło tego dziennika, ale dziennik nie zostanie utworzony, dopóki nie zostanie do niego zapisany pierwszy wpis.When you create a new source for a new event log, the system registers the source for that log, but the log is not created until the first entry is written to it.

Aby zainstalować dziennik zdarzeń, należy utworzyć klasę Instalatora projektu, która dziedziczy po Installer , i ustawić RunInstallerAttribute dla klasy wartość true .To install an event log, create a project installer class that inherits from Installer, and set the RunInstallerAttribute for the class to true. W projekcie Utwórz EventLogInstaller dla każdego dziennika zdarzeń, do którego aplikacja będzie pisać, i Dodaj wystąpienie do klasy Instalatora projektu.Within your project, create an EventLogInstaller for each event log that your application will write to and add the instance to your project installer class.

Gdy Installutil.exe (Narzędzie instalatora) jest wywoływana, wygląda na RunInstallerAttribute .When the Installutil.exe (Installer Tool) is called, it looks at the RunInstallerAttribute. Jeśli tak jest true , narzędzie zainstaluje wszystkie elementy w Installers kolekcji, które są skojarzone z instalatorem projektu.If it is true, the tool installs all the items in the Installers collection that are associated with your project installer. Jeśli RunInstallerAttribute jest false , narzędzie ignoruje Instalatora projektu.If RunInstallerAttribute is false, the tool ignores the project installer.

Należy zmodyfikować inne właściwości EventLogInstaller przed lub po dodaniu wystąpienia do Installers kolekcji Instalatora projektu, ale przed uruchomieniem narzędzia Instalatora.You modify other properties of an EventLogInstaller either before or after adding the instance to the Installers collection of your project installer, but before the installer tool runs. Właściwość należy ustawić, Source Jeśli aplikacja będzie zapisywać w dzienniku zdarzeń.You must set the Source property if your application will be writing to the event log.

Służy EventLogInstaller do rejestrowania nowego źródła dla nowego lub istniejącego dziennika zdarzeń; nie należy używać EventLogInstaller do zmiany istniejącego źródła.Use EventLogInstaller to register a new source for a new or existing event log; do not use EventLogInstaller to change an existing source. EventLogInstallerKlasa nie modyfikuje właściwości konfiguracji istniejącego źródła, aby pasowały do określonych właściwości instalacji.The EventLogInstaller class does not modify the configuration properties of an existing source to match the specified installation properties. InstallMetoda zgłasza wyjątek, jeśli Source Właściwość jest zgodna z nazwą źródła, która jest zarejestrowana dla innego dziennika zdarzeń na komputerze.The Install method throws an exception if the Source property matches a source name that is registered for a different event log on the computer. InstallMetoda 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 we Log właściwości.The Install method does not register the source if the Source property matches a source name that is already registered for the same event log specified in the Log property.

Źródło zdarzeń można zarejestrować przy użyciu zlokalizowanych plików zasobów dla kategorii zdarzeń i ciągów komunikatów.You can register the event source with localized resource files for your event category and message strings. Aplikacja może zapisywać wpisy dziennika zdarzeń przy użyciu identyfikatorów zasobów zamiast określać rzeczywisty ciąg.Your application can write event log entries using resource identifiers, rather than specifying the actual string. 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.The Event Viewer uses the resource identifier to find and display the corresponding string from the localized resource file based on current language settings. Można zarejestrować osobny plik dla kategorii zdarzeń, komunikatów i ciągów wstawiania parametrów lub można zarejestrować ten sam plik zasobu dla wszystkich trzech typów ciągów.You can register a separate file for event categories, messages, and parameter insertion strings, or you can register the same resource file for all three types of strings. Użyj CategoryCount właściwości, CategoryResourceFile , MessageResourceFile i, ParameterResourceFile Aby skonfigurować źródło do zapisywania zlokalizowanych wpisów w dzienniku zdarzeń.Use the CategoryCount, CategoryResourceFile, MessageResourceFile, and ParameterResourceFile properties to configure the source to write localized entries to the event log. Jeśli aplikacja zapisuje wartości ciągów bezpośrednio do dziennika zdarzeń, nie trzeba ustawiać tych właściwości.If your application writes strings values directly to the event log, you do not need to set these properties.

Źródło musi być skonfigurowane do zapisywania zlokalizowanych wpisów lub do pisania ciągów bezpośrednich.The source must be configured either for writing localized entries or for writing direct strings. Jeśli aplikacja zapisuje wpisy przy użyciu zarówno identyfikatorów zasobów, jak i wartości ciągów, należy zarejestrować dwa oddzielne źródła.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Na przykład Skonfiguruj jedno źródło z plikami zasobów, a następnie użyj tego źródła w WriteEvent metodzie do zapisu wpisów przy użyciu identyfikatorów zasobów do dziennika zdarzeń.For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. Utwórz inne źródło bez plików zasobów, a następnie użyj tego źródła w WriteEntry metodzie, aby pisać ciągi bezpośrednio do dziennika zdarzeń przy użyciu tego źródła.Create a different source without resource files and then use that source in the WriteEntry method to write strings directly to the event log using that source.

Zazwyczaj nie wywołujemy metod EventLogInstaller klasy z poziomu kodu; są one zwykle wywoływane tylko przez Installutil.exe.Typically, you do not call the methods of the EventLogInstaller class from within your code; they are generally called only by Installutil.exe. Narzędzie automatycznie wywołuje metodę w Install trakcie procesu instalacji.The tool automatically calls the Install method during the installation process. W razie potrzeby wykonuje kopię zapasową błędów, wywołując Rollback metodę dla obiektu, który wygenerował wyjątek.It backs out failures, if necessary, by calling the Rollback method for the object that generated the exception.

Konstruktory

EventLogInstaller()

Inicjuje nowe wystąpienie klasy EventLogInstaller.Initializes a new instance of the EventLogInstaller class.

Właściwości

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.Gets a value indicating whether the component can raise an event.

(Odziedziczone po Component)
CategoryCount

Pobiera lub ustawia liczbę kategorii w pliku zasobów kategorii.Gets or sets the number of categories in the category resource file.

CategoryResourceFile

Pobiera lub ustawia ścieżkę pliku zasobów, który zawiera ciągi kategorii dla źródła.Gets or sets the path of the resource file that contains category strings for the source.

Container

Pobiera IContainer , który zawiera Component .Gets the IContainer that contains the Component.

(Odziedziczone po Component)
Context

Pobiera lub ustawia informacje o bieżącej instalacji.Gets or sets information about the current installation.

(Odziedziczone po Installer)
DesignMode

Pobiera wartość wskazującą, czy Component jest aktualnie w trybie projektowania.Gets a value that indicates whether the Component is currently in design mode.

(Odziedziczone po Component)
Events

Pobiera listę programów obsługi zdarzeń, które są dołączone do tego elementu Component .Gets the list of event handlers that are attached to this Component.

(Odziedziczone po Component)
HelpText

Pobiera tekst pomocy dla wszystkich instalatorów w kolekcji Instalatora.Gets the help text for all the installers in the installer collection.

(Odziedziczone po Installer)
Installers

Pobiera kolekcję instalatorów, które zawiera ten Instalator.Gets the collection of installers that this installer contains.

(Odziedziczone po Installer)
Log

Pobiera lub ustawia nazwę dziennika, dla którego ma zostać ustawione źródło.Gets or sets the name of the log to set the source to.

MessageResourceFile

Pobiera lub ustawia ścieżkę pliku zasobów, który zawiera ciągi formatowania komunikatu dla źródła.Gets or sets the path of the resource file that contains message formatting strings for the source.

ParameterResourceFile

Pobiera lub ustawia ścieżkę pliku zasobów, który zawiera ciągi parametrów komunikatów dla źródła.Gets or sets the path of the resource file that contains message parameter strings for the source.

Parent

Pobiera lub ustawia Instalator zawierający kolekcję, do której należy ten Instalator.Gets or sets the installer containing the collection that this installer belongs to.

(Odziedziczone po Installer)
Site

Pobiera lub ustawia wartość ISite Component .Gets or sets the ISite of the Component.

(Odziedziczone po Component)
Source

Pobiera lub ustawia nazwę źródła do zarejestrowania w dzienniku.Gets or sets the source name to register with the log.

UninstallAction

Pobiera lub ustawia wartość wskazującą, czy Installutil.exe (Narzędzie instalatora) powinna usunąć dziennik zdarzeń lub pozostawić go w stanie zainstalowanym w czasie dezinstalacji.Gets or sets a value that indicates whether the Installutil.exe (Installer Tool) should remove the event log or leave it in its installed state at uninstall time.

Metody

Commit(IDictionary)

Gdy jest zastępowany w klasie pochodnej, uzupełnia transakcja instalacji.When overridden in a derived class, completes the install transaction.

(Odziedziczone po Installer)
CopyFromComponent(IComponent)

Kopiuje wartości właściwości EventLog składnika, który jest wymagany w czasie instalacji dziennika zdarzeń.Copies the property values of an EventLog component that are required at installation time for an event log.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszelkie zasoby używane przez element Component.Releases all resources used by the Component.

(Odziedziczone po Component)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Odziedziczone po Component)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczoną przez Component lub przez Container .Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
Install(IDictionary)

Wykonuje instalację i zapisuje informacje dziennika zdarzeń do rejestru.Performs the installation and writes event log information to the registry.

IsEquivalentInstaller(ComponentInstaller)

Określa, czy Instalator i inny określony Instalator odwołują się do tego samego źródła.Determines whether an installer and another specified installer refer to the same source.

MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
OnAfterInstall(IDictionary)

Podnosi AfterInstall zdarzenie.Raises the AfterInstall event.

(Odziedziczone po Installer)
OnAfterRollback(IDictionary)

Podnosi AfterRollback zdarzenie.Raises the AfterRollback event.

(Odziedziczone po Installer)
OnAfterUninstall(IDictionary)

Podnosi AfterUninstall zdarzenie.Raises the AfterUninstall event.

(Odziedziczone po Installer)
OnBeforeInstall(IDictionary)

Podnosi BeforeInstall zdarzenie.Raises the BeforeInstall event.

(Odziedziczone po Installer)
OnBeforeRollback(IDictionary)

Podnosi BeforeRollback zdarzenie.Raises the BeforeRollback event.

(Odziedziczone po Installer)
OnBeforeUninstall(IDictionary)

Podnosi BeforeUninstall zdarzenie.Raises the BeforeUninstall event.

(Odziedziczone po Installer)
OnCommitted(IDictionary)

Podnosi Committed zdarzenie.Raises the Committed event.

(Odziedziczone po Installer)
OnCommitting(IDictionary)

Podnosi Committing zdarzenie.Raises the Committing event.

(Odziedziczone po Installer)
Rollback(IDictionary)

Przywraca komputer do stanu sprzed instalacji przez wycofanie informacji dziennika zdarzeń, że procedura instalacji zapisała w rejestrze.Restores the computer to the state it was in before the installation by rolling back the event log information that the installation procedure wrote to the registry.

ToString()

Zwraca wartość String zawierającą nazwę Component (jeśli istnieje).Returns a String containing the name of the Component, if any. Ta metoda nie powinna być przesłaniana.This method should not be overridden.

(Odziedziczone po Component)
Uninstall(IDictionary)

Usuwa instalację, usuwając informacje dziennika zdarzeń z rejestru.Removes an installation by removing event log information from the registry.

Zdarzenia

AfterInstall

Występuje po Install(IDictionary) uruchomieniu metod wszystkich instalatorów we Installers właściwości.Occurs after the Install(IDictionary) methods of all the installers in the Installers property have run.

(Odziedziczone po Installer)
AfterRollback

Występuje po wycofaniu instalacji wszystkich instalatorów we Installers właściwości.Occurs after the installations of all the installers in the Installers property are rolled back.

(Odziedziczone po Installer)
AfterUninstall

Występuje, gdy wszystkie Instalatory we Installers Właściwości wykonują operacje odinstalowywania.Occurs after all the installers in the Installers property perform their uninstallation operations.

(Odziedziczone po Installer)
BeforeInstall

Występuje przed Install(IDictionary) uruchomieniem metody każdego Instalatora w kolekcji Instalatora.Occurs before the Install(IDictionary) method of each installer in the installer collection has run.

(Odziedziczone po Installer)
BeforeRollback

Występuje przed wycofaniem instalatorów we Installers właściwości.Occurs before the installers in the Installers property are rolled back.

(Odziedziczone po Installer)
BeforeUninstall

Występuje przed Installers wykonaniem operacji odinstalowywania przez instalatorów we właściwości.Occurs before the installers in the Installers property perform their uninstall operations.

(Odziedziczone po Installer)
Committed

Występuje po Installers pomyślnej instalacji wszystkich instalatorów we właściwości.Occurs after all the installers in the Installers property have committed their installations.

(Odziedziczone po Installer)
Committing

Występuje przed zatwierdzeniem instalacji przez instalatorów we Installers właściwości.Occurs before the installers in the Installers property commit their installations.

(Odziedziczone po Installer)
Disposed

Występuje, gdy składnik zostanie usunięty przez wywołanie Dispose() metody.Occurs when the component is disposed by a call to the Dispose() method.

(Odziedziczone po Component)

Dotyczy

Zobacz też