EventLogInstaller Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Configuration.Install.dll

Umožňuje nainstalovat a nakonfigurovat protokol událostí, ze kterého vaše aplikace při spuštění načítá nebo zapisuje.

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

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

EventLogInstaller

Příklady

Následující příklad kódu nastaví vlastnosti instalace pro nový zdroj událostí. Příklad kódu nastaví název zdroje a název protokolu událostí a přidá do EventLogInstallerInstallers kolekce.

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

Nástroj EventLogInstaller proInstallutil.exe (instalační program) se používá při instalaci protokolu událostí. Třída EventLogInstaller může instalovat protokoly událostí pouze do místního počítače.

EventLogInstaller Třídu použijte, když vaše aplikace zapisuje do protokolu událostí; není nutné použít instalační program protokolu událostí pro vaši aplikaci ke čtení z protokolu událostí. Aplikace a služby by měly zapisovat do protokolu aplikace nebo do vlastního protokolu. Ovladače zařízení by se měly zapisovat do systémového protokolu.

Poznámka:

Protokol zabezpečení je jen pro čtení.

Instalační program vytvoří zdroj událostí, který zadáte ve Source vlastnosti, a zaregistruje ho pro protokol událostí zadaný ve Log vlastnosti. Toto chování se podobá volání CreateEventSource komponenty EventLog .

K zápisu WriteEvent událostí do protokolu událostí použijte metody a WriteEntry metody. Je nutné zadat zdroj událostí pro zápis událostí; Před zápisem první položky se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí.

Během instalace aplikace vytvořte nový zdroj událostí. Díky tomu může operační systém aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurací. Pokud operační systém neaktualizuje seznam zdrojů událostí a pokusíte se napsat událost s novým zdrojem, operace zápisu selže. Nový zdroj můžete nakonfigurovat pomocí metody EventLogInstallernebo metody CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít na počítači oprávnění správce.

Můžete vytvořit zdroj událostí pro existující protokol událostí nebo nový protokol událostí. Když vytvoříte nový zdroj pro nový protokol událostí, systém zaregistruje zdroj pro tento protokol, ale protokol se nevytvoří, dokud se do něj nezapíše první položka.

Chcete-li nainstalovat protokol událostí, vytvořte třídu instalačního programu projektu, která dědí z Installer, a nastavte RunInstallerAttribute třídu pro třídu na true. V rámci projektu vytvořte EventLogInstaller pro každý protokol událostí, do kterého bude vaše aplikace zapisovat a přidat instanci do třídy instalačního programu projektu.

Když je volána Installutil.exe (instalační nástroj), podívá se na RunInstallerAttribute. Pokud ano true, nástroj nainstaluje všechny položky v Installers kolekci, které jsou přidružené k instalačnímu programu projektu. Pokud RunInstallerAttribute ano false, nástroj ignoruje instalační program projektu.

Jiné vlastnosti 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 instalačního programu. Vlastnost musíte nastavit Source , pokud vaše aplikace zapisuje do protokolu událostí.

Slouží EventLogInstaller k registraci nového zdroje pro nový nebo existující protokol událostí. Nepoužívejte EventLogInstaller ke změně existujícího zdroje. Třída EventLogInstaller neupravuje vlastnosti konfigurace existujícího zdroje tak, aby odpovídaly zadaným vlastnostem instalace. Metoda Install vyvolá výjimku, pokud Source vlastnost odpovídá zdrojovému názvu, který je registrován pro jiný protokol událostí v počítači. Metoda Install neregistruje zdroj, pokud Source vlastnost odpovídá názvu zdroje, který je již registrován pro stejný protokol událostí zadaný ve Log vlastnosti.

Zdroj událostí můžete zaregistrovat v lokalizovaných souborech prostředků pro vaši kategorii událostí a řetězce zpráv. Aplikace může zapisovat položky protokolu událostí pomocí identifikátorů prostředků, a nikoli zadávat skutečný řetězec. 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. 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ů. CategoryCountKe konfiguraci zdroje pro zápis lokalizovaných položek do protokolu událostí použijte příkazy , CategoryResourceFile, MessageResourceFilea ParameterResourceFile vlastnosti. Pokud vaše aplikace zapisuje hodnoty řetězců přímo do protokolu událostí, nemusíte tyto vlastnosti nastavovat.

Zdroj musí být nakonfigurován buď pro zápis lokalizovaných položek, nebo pro zápis přímých řetězců. Pokud vaše aplikace zapisuje položky pomocí identifikátorů prostředků i řetězcových hodnot, musíte zaregistrovat dva samostatné zdroje. Například nakonfigurujte jeden zdroj se soubory prostředků a pak tento zdroj v WriteEvent metodě použijte k zápisu položek pomocí identifikátorů prostředků do protokolu událostí. Vytvořte jiný zdroj bez souborů prostředků a pak tento zdroj v WriteEntry metodě použijte k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.

Obvykle nevoláte metody EventLogInstaller třídy z kódu; jsou obecně volána pouze Installutil.exe. Nástroj během procesu instalace automaticky volá metodu Install . V případě potřeby vyvrátí selhání voláním Rollback metody pro objekt, který vygeneroval výjimku.

Konstruktory

Name	Description
EventLogInstaller()	Inicializuje novou instanci EventLogInstaller třídy.

Vlastnosti

Name	Description
CanRaiseEvents	Získá hodnotu určující, zda komponenta může vyvolat událost. (Zděděno od Component)
CategoryCount	Získá nebo nastaví počet kategorií v souboru prostředků kategorie.
CategoryResourceFile	Získá nebo nastaví cestu k souboru prostředků, který obsahuje řetězce kategorií pro zdroj.
Container	Získá ten IContainer , který obsahuje Component. (Zděděno od Component)
Context	Získá nebo nastaví informace o aktuální instalaci. (Zděděno od Installer)
DesignMode	Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu. (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
HelpText	Získá text nápovědy pro všechny instalační programy v kolekci instalačního programu. (Zděděno od Installer)
Installers	Získá kolekci instalačních programů, které tento instalační program obsahuje. (Zděděno od Installer)
Log	Získá nebo nastaví název protokolu pro nastavení zdroje na.
MessageResourceFile	Získá nebo nastaví cestu k souboru prostředků, který obsahuje řetězce formátování zpráv pro zdroj.
ParameterResourceFile	Získá nebo nastaví cestu k souboru prostředků, který obsahuje řetězce parametrů zprávy pro zdroj.
Parent	Získá nebo nastaví instalační program obsahující kolekci, do které tento instalační program patří. (Zděděno od Installer)
Site	Získá nebo nastaví ISite .Component (Zděděno od Component)
Source	Získá nebo nastaví název zdroje pro registraci v protokolu.
UninstallAction	Získá nebo nastaví hodnotu, která označuje, zda Installutil.exe (instalační nástroj) má odebrat protokol událostí nebo nechat v jeho nainstalovaném stavu v době odinstalace.

Metody

Name	Description
Commit(IDictionary)	Při přepsání v odvozené třídě dokončí instalaci transakce. (Zděděno od Installer)
CopyFromComponent(IComponent)	Zkopíruje hodnoty EventLog vlastností komponenty, které jsou vyžadovány v době instalace protokolu událostí.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané Component a volitelně uvolní spravované prostředky. (Zděděno od Component)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jeho Container. (Zděděno od Component)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
Install(IDictionary)	Provede instalaci a zapíše informace protokolu událostí do registru.
IsEquivalentInstaller(ComponentInstaller)	Určuje, zda instalační program a jiný zadaný instalační program odkazují na stejný zdroj.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
OnAfterInstall(IDictionary)	AfterInstall Vyvolá událost. (Zděděno od Installer)
OnAfterRollback(IDictionary)	AfterRollback Vyvolá událost. (Zděděno od Installer)
OnAfterUninstall(IDictionary)	AfterUninstall Vyvolá událost. (Zděděno od Installer)
OnBeforeInstall(IDictionary)	BeforeInstall Vyvolá událost. (Zděděno od Installer)
OnBeforeRollback(IDictionary)	BeforeRollback Vyvolá událost. (Zděděno od Installer)
OnBeforeUninstall(IDictionary)	BeforeUninstall Vyvolá událost. (Zděděno od Installer)
OnCommitted(IDictionary)	Committed Vyvolá událost. (Zděděno od Installer)
OnCommitting(IDictionary)	Committing Vyvolá událost. (Zděděno od Installer)
Rollback(IDictionary)	Obnoví počítač do stavu, ve který byl před instalací, vrácením informací protokolu událostí, které instalační postup napsal do registru.
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)
Uninstall(IDictionary)	Odebere instalaci odebráním informací protokolu událostí z registru.

Událost

Name	Description
AfterInstall	Nastane po Install(IDictionary) spuštění metod všech instalačních programů ve Installers vlastnosti. (Zděděno od Installer)
AfterRollback	Nastane po instalaci všech instalačních programů ve Installers vlastnosti se vrátí zpět. (Zděděno od Installer)
AfterUninstall	Nastane po všech instalačních programech ve Installers vlastnosti provádět své operace odinstalace. (Zděděno od Installer)
BeforeInstall	Nastane před spuštěním Install(IDictionary) metody každého instalačního programu v kolekci instalačního programu. (Zděděno od Installer)
BeforeRollback	Nastane před vrácením instalačních programů ve Installers vlastnosti. (Zděděno od Installer)
BeforeUninstall	Nastane dříve, než instalační programy ve Installers vlastnosti provádějí své operace odinstalace. (Zděděno od Installer)
Committed	Nastane po potvrzení všech instalačních programů ve Installers vlastnosti jejich instalace. (Zděděno od Installer)
Committing	Nastane před instalačními programy ve Installers vlastnosti potvrdí jejich instalace. (Zděděno od Installer)
Disposed	Nastane, když komponenta je uvolněna voláním Dispose() metody. (Zděděno od Component)

Viz také

• EventLog
• CreateEventSource
• Installutil.exe (instalační nástroj)