EventLogInstaller Třída

Definice

Umožňuje nainstalovat a nakonfigurovat protokol událostí, ze kterého aplikace čte, nebo do nich zapisovat, pokud je spuštěný.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
Dědičnost

Příklady

Následující příklad kódu nastaví vlastnosti instalace pro nový zdroj události.The following code example sets the installation properties for a new event source. Příklad kódu nastaví název zdroje a název protokolu událostí a přidá EventLogInstaller do Installers kolekce.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

Poznámky

Rozhraní EventLogInstaller používá Installutil.exe (nástroj Installer Tool) při instalaci protokolu událostí.The EventLogInstaller is used by the Installutil.exe (Installer Tool) when installing an event log. EventLogInstallerTřída může instalovat protokoly událostí pouze v místním počítači.The EventLogInstaller class can install event logs only on the local computer.

Třídu použijte v případě, že EventLogInstaller vaše aplikace zapisuje do protokolu událostí. pro čtení z protokolu událostí není nutné použít instalační program protokolu událostí.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. Aplikace a služby by měly zapisovat do aplikačního protokolu nebo vlastního protokolu.Applications and services should write to the Application log or a custom log. Ovladače zařízení by měly zapisovat do systémového protokolu.Device drivers should write to the System log.

Poznámka

Protokol zabezpečení je jen pro čtení.The Security log is read-only.

Instalační program vytvoří zdroj události, který zadáte do Source vlastnosti, a zaregistruje jej pro protokol událostí určený ve Log Vlastnosti.The installer creates the event source that you specify in the Source property and registers it for the event log specified in Log property. Toto chování je podobné jako volání CreateEventSource na EventLog komponentu.This behavior is similar to calling CreateEventSource on the EventLog component.

Pomocí WriteEvent metod a WriteEntry zapište události do protokolu událostí.Use the WriteEvent and WriteEntry methods to write events to an event log. Je nutné zadat zdroj události pro zápis událostí. než začnete psát první záznam se zdrojem, je nutné vytvořit a nakonfigurovat zdroj události.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.

Vytvořte nový zdroj události během instalace aplikace.Create the new event source during the installation of your application. To umožňuje, aby operační systém aktualizoval svůj seznam registrovaných zdrojů událostí a jejich konfigurací.This allows time for the operating system to refresh its list of registered event sources and their configurations. Pokud operační systém neaktualizoval svůj seznam zdrojů událostí a pokusíte se zapsat událost s novým zdrojem, operace zápisu selže.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. Můžete nakonfigurovat nový zdroj pomocí EventLogInstaller nebo pomocí CreateEventSource metody.You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. K vytvoření nového zdroje událostí musíte mít v počítači oprávnění správce.You must have administrative rights on the computer to create a new event source.

Můžete vytvořit zdroj události pro existující protokol událostí nebo nový protokol událostí.You can create an event source for an existing event log or a new event log. Při vytváření nového zdroje nového protokolu událostí systém zaregistruje zdroj pro tento protokol, ale protokol se nevytvoří, dokud se do něj nezapíše první položka.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.

Chcete-li nainstalovat protokol událostí, vytvořte instalační třídu projektu, která dědí z Installer a nastavte RunInstallerAttribute třídu pro třídu na true .To install an event log, create a project installer class that inherits from Installer, and set the RunInstallerAttribute for the class to true. V rámci projektu vytvořte EventLogInstaller pro každý protokol událostí, do kterého bude aplikace zapisovat, a přidejte instanci do vaší projektové instalační třídy 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.

Když je zavolána Installutil.exe (nástroj Installer Tool) , je zobrazena v RunInstallerAttribute .When the Installutil.exe (Installer Tool) is called, it looks at the RunInstallerAttribute. Pokud je true , nástroj nainstaluje všechny položky v Installers kolekci, které jsou přidruženy k vašemu instalačnímu programu projektu.If it is true, the tool installs all the items in the Installers collection that are associated with your project installer. Pokud RunInstallerAttribute je false , nástroj ignoruje instalační program projektu.If RunInstallerAttribute is false, the tool ignores the project installer.

Úpravou dalších vlastností EventLogInstaller buď před, nebo po přidání instance do Installers kolekce instalačního programu projektu, ale před spuštěním nástroje instalačního programu.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. Tuto vlastnost je nutné nastavit, Source Pokud bude aplikace zapsána do protokolu událostí.You must set the Source property if your application will be writing to the event log.

Slouží EventLogInstaller k registraci nového zdroje pro nový nebo existující protokol událostí. Nepoužívejte EventLogInstaller ke změně stávajícího zdroje.Use EventLogInstaller to register a new source for a new or existing event log; do not use EventLogInstaller to change an existing source. EventLogInstallerTřída neupravuje vlastnosti konfigurace stávajícího zdroje tak, aby odpovídaly zadaným vlastnostem instalace.The EventLogInstaller class does not modify the configuration properties of an existing source to match the specified installation properties. InstallMetoda vyvolá výjimku Source , pokud vlastnost odpovídá názvu zdroje, který je zaregistrován pro jiný protokol událostí v počítači.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 neregistruje zdroj Source , pokud vlastnost odpovídá názvu zdroje, který je již zaregistrován pro stejný protokol událostí zadaný ve Log Vlastnosti.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.

Můžete zaregistrovat zdroj události s lokalizovanými soubory prostředků pro kategorii události a řetězce zpráv.You can register the event source with localized resource files for your event category and message strings. Aplikace může zapisovat položky protokolu událostí pomocí identifikátorů prostředků namísto zadání skutečného řetězce.Your application can write event log entries using resource identifiers, rather than specifying the actual string. Prohlížeč událostí používá identifikátor prostředku k vyhledání a zobrazení odpovídajícího řetězce z lokalizovaného souboru prostředků na základě aktuálního nastavení jazyka.The Event Viewer uses the resource identifier to find and display the corresponding string from the localized resource file based on current language settings. Můžete zaregistrovat samostatný soubor pro kategorie událostí, zprávy a řetězce vložení parametrů, nebo můžete zaregistrovat stejný soubor prostředků pro všechny tři typy řetězců.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. Použijte CategoryCount vlastnosti, CategoryResourceFile , MessageResourceFile a ParameterResourceFile ke konfiguraci zdroje pro zápis lokalizovaných položek do protokolu událostí.Use the CategoryCount, CategoryResourceFile, MessageResourceFile, and ParameterResourceFile properties to configure the source to write localized entries to the event log. Pokud vaše aplikace zapisuje hodnoty řetězců přímo do protokolu událostí, nemusíte tyto vlastnosti nastavovat.If your application writes strings values directly to the event log, you do not need to set these properties.

Zdroj musí být nakonfigurován buď pro zápis lokalizovaných záznamů, nebo pro zápis přímých řetězců.The source must be configured either for writing localized entries or for writing direct strings. Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků a hodnot řetězce, je nutné zaregistrovat dva samostatné zdroje.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Například nakonfigurujte jeden zdroj se soubory prostředků a pak použijte tento zdroj v WriteEvent metodě k zápisu položek pomocí identifikátorů prostředků do protokolu událostí.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. Vytvořte jiný zdroj bez souborů prostředků a pak použijte tento zdroj v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí tohoto zdroje.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.

Obvykle nevoláte metody EventLogInstaller třídy v rámci kódu; jsou obecně volány pouze pomocí 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. Nástroj Install během procesu instalace automaticky zavolá metodu.The tool automatically calls the Install method during the installation process. V případě potřeby vrátí selhání voláním Rollback metody pro objekt, který výjimku vygeneroval.It backs out failures, if necessary, by calling the Rollback method for the object that generated the exception.

Konstruktory

EventLogInstaller()

Inicializuje novou instanci EventLogInstaller třídy.Initializes a new instance of the EventLogInstaller class.

Vlastnosti

CanRaiseEvents

Získá hodnotu, která označuje, zda může komponenta vyvolat událost.Gets a value indicating whether the component can raise an event.

(Zděděno od Component)
CategoryCount

Získá nebo nastaví počet kategorií v souboru prostředků kategorie.Gets or sets the number of categories in the category resource file.

CategoryResourceFile

Získá nebo nastaví cestu k souboru prostředků, který obsahuje řetězce kategorií pro zdroj.Gets or sets the path of the resource file that contains category strings for the source.

Container

Získá IContainer , který obsahuje Component .Gets the IContainer that contains the Component.

(Zděděno od Component)
Context

Získá nebo nastaví informace o aktuální instalaci.Gets or sets information about the current installation.

(Zděděno od Installer)
DesignMode

Načte hodnotu, která označuje, zda Component je aktuálně v režimu návrhu.Gets a value that indicates whether the Component is currently in design mode.

(Zděděno od Component)
Events

Získá seznam obslužných rutin událostí, které jsou k tomuto typu připojeny Component .Gets the list of event handlers that are attached to this Component.

(Zděděno od Component)
HelpText

Získá text helpu pro všechny instalační služby v kolekci instalačních programů.Gets the help text for all the installers in the installer collection.

(Zděděno od Installer)
Installers

Získá kolekci instalačních programů, které tento instalační program obsahuje.Gets the collection of installers that this installer contains.

(Zděděno od Installer)
Log

Získá nebo nastaví název protokolu pro nastavení zdroje.Gets or sets the name of the log to set the source to.

MessageResourceFile

Získá nebo nastaví cestu k souboru prostředků, který obsahuje řetězce formátování zprávy pro zdroj.Gets or sets the path of the resource file that contains message formatting strings for the source.

ParameterResourceFile

Získá nebo nastaví cestu k souboru prostředků, který obsahuje řetězce parametrů zprávy pro zdroj.Gets or sets the path of the resource file that contains message parameter strings for the source.

Parent

Získá nebo nastaví instalační službu obsahující kolekci, do které patří tento instalační program.Gets or sets the installer containing the collection that this installer belongs to.

(Zděděno od Installer)
Site

Získá nebo nastaví ISite z Component .Gets or sets the ISite of the Component.

(Zděděno od Component)
Source

Získá nebo nastaví název zdroje, který se má zaregistrovat v protokolu.Gets or sets the source name to register with the log.

UninstallAction

Získává nebo nastavuje hodnotu, která indikuje, jestli Installutil.exe (nástroj Installer Tool) má odebrat protokol událostí nebo ho nechat v nainstalovaném stavu při odinstalaci.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)

Při přepsání v odvozené třídě dokončí instalaci transakce.When overridden in a derived class, completes the install transaction.

(Zděděno od Installer)
CopyFromComponent(IComponent)

Zkopíruje hodnoty vlastností EventLog komponenty, které jsou požadovány v době instalace pro protokol událostí.Copies the property values of an EventLog component that are required at installation time for an event log.

CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace požadované pro vygenerování proxy serveru, který se používá ke komunikaci se vzdáleným objektem.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Zděděno od MarshalByRefObject)
Dispose()

Uvolní všechny prostředky, které používá Component .Releases all resources used by the Component.

(Zděděno od Component)
Dispose(Boolean)

Uvolní nespravované prostředky používané Component a volitelně uvolňuje spravované prostředky.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Zděděno od Component)
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetLifetimeService()
Zastaralé.

Načte aktuální objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Zděděno od MarshalByRefObject)
GetService(Type)

Vrátí objekt, který představuje službu poskytnutou Component nebo podle jeho Container .Returns an object that represents a service provided by the Component or by its Container.

(Zděděno od Component)
GetType()

Získá Type aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
InitializeLifetimeService()
Zastaralé.

Získá objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Obtains a lifetime service object to control the lifetime policy for this instance.

(Zděděno od MarshalByRefObject)
Install(IDictionary)

Provede instalaci a zapíše informace protokolu událostí do registru.Performs the installation and writes event log information to the registry.

IsEquivalentInstaller(ComponentInstaller)

Určuje, zda instalační program a jiný zadaný instalační program odkazuje na stejný zdroj.Determines whether an installer and another specified installer refer to the same source.

MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří kopii aktuálního objektu bez podstruktury MarshalByRefObject .Creates a shallow copy of the current MarshalByRefObject object.

(Zděděno od MarshalByRefObject)
OnAfterInstall(IDictionary)

Vyvolá AfterInstall událost.Raises the AfterInstall event.

(Zděděno od Installer)
OnAfterRollback(IDictionary)

Vyvolá AfterRollback událost.Raises the AfterRollback event.

(Zděděno od Installer)
OnAfterUninstall(IDictionary)

Vyvolá AfterUninstall událost.Raises the AfterUninstall event.

(Zděděno od Installer)
OnBeforeInstall(IDictionary)

Vyvolá BeforeInstall událost.Raises the BeforeInstall event.

(Zděděno od Installer)
OnBeforeRollback(IDictionary)

Vyvolá BeforeRollback událost.Raises the BeforeRollback event.

(Zděděno od Installer)
OnBeforeUninstall(IDictionary)

Vyvolá BeforeUninstall událost.Raises the BeforeUninstall event.

(Zděděno od Installer)
OnCommitted(IDictionary)

Vyvolá Committed událost.Raises the Committed event.

(Zděděno od Installer)
OnCommitting(IDictionary)

Vyvolá Committing událost.Raises the Committing event.

(Zděděno od Installer)
Rollback(IDictionary)

Vrátí počítač do stavu, ve kterém byl před instalací, vrácením informací v protokolu událostí, které instalační procedura zapsala do registru.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()

Vrátí hodnotu String obsahující název Component , pokud existuje.Returns a String containing the name of the Component, if any. Tato metoda by neměla být přepsána.This method should not be overridden.

(Zděděno od Component)
Uninstall(IDictionary)

Odebere instalaci z registru odebráním informací z protokolu událostí.Removes an installation by removing event log information from the registry.

Události

AfterInstall

Nastane po Install(IDictionary) spuštění metod všech instalačních programů ve Installers Vlastnosti.Occurs after the Install(IDictionary) methods of all the installers in the Installers property have run.

(Zděděno od Installer)
AfterRollback

Nastane po vrácení instalace všech instalačních programů ve Installers vlastnosti zpět.Occurs after the installations of all the installers in the Installers property are rolled back.

(Zděděno od Installer)
AfterUninstall

Vyvolá se po provedení operací odinstalace všemi instalačními programy ve Installers Vlastnosti.Occurs after all the installers in the Installers property perform their uninstallation operations.

(Zděděno od Installer)
BeforeInstall

Proběhne před Install(IDictionary) spuštěním metody každého instalačního programu v kolekci instalačních programů.Occurs before the Install(IDictionary) method of each installer in the installer collection has run.

(Zděděno od Installer)
BeforeRollback

Vyvolá se před vrácením instalačních programů ve Installers vlastnosti zpět.Occurs before the installers in the Installers property are rolled back.

(Zděděno od Installer)
BeforeUninstall

Proběhne před tím, než instalační programy v této Installers vlastnosti provede operace odinstalace.Occurs before the installers in the Installers property perform their uninstall operations.

(Zděděno od Installer)
Committed

Vyvolá se poté, co všechny instalační programy ve Installers vlastnosti potvrdí své instalace.Occurs after all the installers in the Installers property have committed their installations.

(Zděděno od Installer)
Committing

Proběhne před tím, než instalační programy ve Installers vlastnosti potvrdí jejich instalaci.Occurs before the installers in the Installers property commit their installations.

(Zděděno od Installer)
Disposed

Nastane, pokud je komponenta uvolněna voláním Dispose() metody.Occurs when the component is disposed by a call to the Dispose() method.

(Zděděno od Component)

Platí pro

Viz také