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 načítá nebo do kterého zapisuje při spuštění.

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á 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

Používá EventLogInstallerInstallutil.exe (instalační nástroj) při instalaci protokolu událostí. Třída EventLogInstaller může nainstalovat 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í. 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í je podobné 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 se zdrojem musíte vytvořit a nakonfigurovat zdroj událostí.

Nový zdroj událostí vytvořte během instalace aplikace. 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í EventLogInstaller, nebo pomocí CreateEventSource metody . K vytvoření nového zdroje 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 do něj není zapsána 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 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řidejte instanci do třídy instalačního programu projektu.

Při zavoláníInstallutil.exe (instalační nástroj) se zobrazí RunInstallerAttribute. Pokud je 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 vlastnostem instalace. 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ž registrován pro stejný protokol událostí zadaný ve Log vlastnosti .

Zdroj událostí můžete zaregistrovat s lokalizovanými soubory 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ů, místo aby určila 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 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 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 ho WriteEvent použijte v metodě 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 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 kódu; obvykle jsou volána pouze Installutil.exe. Nástroj volá metodu Install automaticky během procesu instalace. 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ředků, 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ředků, který obsahuje řetězce formátování zprávy 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é patří tento instalační program. (Zděděno od Installer)
Site	Získá nebo nastaví ISite z 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 ponechat v 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 pož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 sloužící 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é nástrojem Component 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 aktuální životnost objektu služby, 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 .Container (Zděděno od Component)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Získá životnost objektu služby, 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é postup instalace zapsal do registru.
ToString()	String Vrátí hodnotu obsahující název , Componentpokud 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	Vyvolá se Install(IDictionary) po spuštění metod všech instalačních programů ve Installers vlastnosti . (Zděděno od Installer)
AfterRollback	Vyvolá se po vrácení instalací všech instalačních programů ve Installers vlastnosti zpět. (Zděděno od Installer)
AfterUninstall	Vyvolá se poté, co všechny instalační programy ve Installers vlastnosti provedou 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ředtím, než instalační programy ve Installers vlastnosti provedou své operace odinstalace. (Zděděno od Installer)
Committed	Vyvolá se poté, co všechny instalační programy ve Installers vlastnosti potvrdily své instalace. (Zděděno od Installer)
Committing	Nastane předtím, než instalační programy ve Installers vlastnosti potvrdí své instalace. (Zděděno od Installer)
Disposed	Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component)

Viz také

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