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í čte nebo do kterého 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á objekt EventLogInstaller do Installers kolekce.

#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

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

Třídu použijte, EventLogInstaller když vaše aplikace zapisuje do protokolu událostí. Pro čtení z protokolu událostí není nutné používat instalační program protokolu událostí. Aplikace a služby by se měly zapisovat do aplikačního protokolu 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 . Je nutné zadat zdroj událostí pro zápis událostí; Před zápisem první položky do zdroje musíte vytvořit a nakonfigurovat zdroj událostí.

Během instalace aplikace vytvořte nový zdroj událostí. Operační systém tak může aktualizovat seznam registrovaných zdrojů událostí a jejich konfigurace. 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í EventLogInstallermetody nebo CreateEventSource . Abyste mohli vytvořit nový zdroj událostí, musíte mít v 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.

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

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

Můžete upravit další vlastnosti EventLogInstaller 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 nástroje. Pokud bude vaše aplikace zapisovat do protokolu událostí, musíte vlastnost nastavit Source .

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 instalačním vlastnostem. Metoda Install vyvolá výjimku, pokud Source vlastnost odpovídá názvu zdroje, 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ž zaregistrován pro stejný protokol událostí zadaný ve Log vlastnosti.

Zdroj událostí můžete zaregistrovat pomocí lokalizovaných souborů prostředků pro vaši kategorii událostí a řetězce zpráv. Vaše aplikace může zapisovat položky protokolu událostí pomocí identifikátorů prostředků, a nezadávat skutečný řetězec. Prohlížeč událostí použije 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 vkládání parametrů nebo můžete zaregistrovat stejný soubor prostředků pro všechny tři typy řetězců. CategoryCountPomocí vlastností , CategoryResourceFile, MessageResourceFilea ParameterResourceFile nakonfigurujte zdroj pro zápis lokalizovaných položek do protokolu událostí. 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 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 použijte v WriteEvent metodě k zápisu položek do protokolu událostí pomocí identifikátorů prostředků. Vytvořte jiný zdroj bez souborů prostředků a pak tento zdroj použijte v WriteEntry metodě k zápisu řetězců přímo do protokolu událostí pomocí daného zdroje.

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

Konstruktory

EventLogInstaller()

Inicializuje novou instanci EventLogInstaller třídy.

Vlastnosti

CanRaiseEvents	Získá hodnotu označ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ředku, který obsahuje řetězce kategorií pro zdroj.
Container	Získá objekt 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 je aktuálně v režimu návrhu Component . (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ředku, který obsahuje řetězce formátování zprávy pro zdroj.
ParameterResourceFile	Získá nebo nastaví cestu k souboru prostředku, který obsahuje řetězce parametrů zprávy pro zdroj.
Parent	Získá nebo nastaví instalační program obsahující kolekci, do které patří tento instalační program. (Zděděno od Installer)
Site	Získá nebo nastaví ISite hodnotu 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) by měl odebrat protokol událostí nebo jej nechat v jeho nainstalovaném stavu při odinstalaci.

Metody

Commit(IDictionary)	Při přepsání v odvozené třídě dokončí transakci instalace. (Zděděno od Installer)
CopyFromComponent(IComponent)	Zkopíruje hodnoty EventLog vlastností komponenty, které jsou vyžadovány v době instalace pro protokol událostí.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používané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 nástrojem a volitelně uvolní spravované prostředky. (Zděděno od Component)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (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 jejím Containerobjektem . (Zděděno od Component)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
InitializeLifetimeService()	Získá objekt služby životnosti, který řídí zásady ž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 Objectsouboru . (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 před instalací vrácením informací protokolu událostí, které instalační procedura zapisovala 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

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 vrácení instalace všech instalačních programů ve Installers vlastnosti zpět. (Zděděno od Installer)
AfterUninstall	Nastane poté, co všechny instalační programy ve Installers vlastnosti provedou 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 zpět. (Zděděno od Installer)
BeforeUninstall	Nastane před tím, než instalační program ve Installers vlastnosti provede své operace odinstalace. (Zděděno od Installer)
Committed	Nastane poté, co všechny instalační programy ve Installers vlastnosti potvrdily své instalace. (Zděděno od Installer)
Committing	Nastane před tím, než instalační programy ve Installers vlastnosti potvrdí své instalace. (Zděděno od Installer)
Disposed	Nastane, když je komponenta odstraněna voláním Dispose() metody. (Zděděno od Component)

Viz také

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