EventLogInstaller EventLogInstaller EventLogInstaller EventLogInstaller Class

Definizione

Consente di installare e configurare un log eventi che l'applicazione legge o nel quale scrive durante l'esecuzione.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
Ereditarietà

Esempi

Nell'esempio di codice seguente vengono impostate le proprietà di installazione per una nuova origine evento.The following code example sets the installation properties for a new event source. Nell'esempio EventLogInstaller Installers di codice vengono impostati il nome dell'origine e il nome del registro eventi e viene aggiunto alla raccolta.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 'MyEventLogInstaller

Commenti

Il EventLogInstaller viene utilizzato da installutil. exe (utilità di installazione) durante l'installazione di un registro eventi.The EventLogInstaller is used by the Installutil.exe (Installer Tool) when installing an event log. La EventLogInstaller classe può installare i registri eventi solo nel computer locale.The EventLogInstaller class can install event logs only on the local computer.

Utilizzare la EventLogInstaller classe quando l'applicazione scrive in un registro eventi. non è necessario utilizzare un programma di installazione del registro eventi per l'applicazione per la lettura da un log eventi.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. Le applicazioni e i servizi devono scrivere nel registro applicazioni o in un log personalizzato.Applications and services should write to the Application log or a custom log. I driver di dispositivo devono scrivere nel registro di sistema.Device drivers should write to the System log.

Nota

Il registro di sicurezza è di sola lettura.The Security log is read-only.

Il programma di installazione crea l'origine evento specificata nella Source proprietà e la registra per il registro eventi specificato nella Log proprietà.The installer creates the event source that you specify in the Source property and registers it for the event log specified in Log property. Questo comportamento è simile alla chiamata CreateEventSource EventLog sul componente.This behavior is similar to calling CreateEventSource on the EventLog component.

Usare i WriteEvent metodi WriteEntry e per scrivere eventi in un log eventi.Use the WriteEvent and WriteEntry methods to write events to an event log. È necessario specificare un'origine evento per la scrittura di eventi; è necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.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.

Creare la nuova origine evento durante l'installazione dell'applicazione.Create the new event source during the installation of your application. Ciò consente al sistema operativo di aggiornare l'elenco delle origini eventi registrate e le relative configurazioni.This allows time for the operating system to refresh its list of registered event sources and their configurations. Se il sistema operativo non ha aggiornato l'elenco delle origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo.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. È possibile configurare una nuova origine usando EventLogInstallero il CreateEventSource metodo.You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. Per creare una nuova origine evento, è necessario disporre dei diritti amministrativi nel computer.You must have administrative rights on the computer to create a new event source.

È possibile creare un'origine evento per un registro eventi esistente o per un nuovo registro eventi.You can create an event source for an existing event log or a new event log. Quando si crea una nuova origine per un nuovo registro eventi, il sistema registra l'origine per tale log, ma il log non viene creato fino a quando non viene scritta la prima voce.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.

Per installare un log eventi, creare una classe del programma di installazione del Installer RunInstallerAttribute progetto che erediti da e impostare per la trueclasse su.To install an event log, create a project installer class that inherits from Installer, and set the RunInstallerAttribute for the class to true. All'interno del progetto, creare EventLogInstaller un per ogni registro eventi in cui l'applicazione scriverà e aggiungere l'istanza alla classe del programma di installazione del progetto.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.

Quando viene chiamato installutil. exe (utilità di installazione) , viene analizzato il RunInstallerAttribute.When the Installutil.exe (Installer Tool) is called, it looks at the RunInstallerAttribute. In caso contrario true, verranno installati tutti gli elementi della raccoltaassociatialprogrammadiInstallers installazione del progetto.If it is true, the tool installs all the items in the Installers collection that are associated with your project installer. Se RunInstallerAttribute èfalse, lo strumento ignora il programma di installazione del progetto.If RunInstallerAttribute is false, the tool ignores the project installer.

È possibile modificare altre proprietà di EventLogInstaller un oggetto prima o dopo l'aggiunta dell'istanza Installers alla raccolta del programma di installazione del progetto, ma prima dell'esecuzione dello strumento di installazione.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. È necessario impostare la Source proprietà se l'applicazione scriverà nel registro eventi.You must set the Source property if your application will be writing to the event log.

Utilizzare EventLogInstaller per registrare una nuova origine per un registro eventi nuovo o esistente. non utilizzare EventLogInstaller per modificare un'origine esistente.Use EventLogInstaller to register a new source for a new or existing event log; do not use EventLogInstaller to change an existing source. La EventLogInstaller classe non modifica le proprietà di configurazione di un'origine esistente in modo che corrispondano alle proprietà di installazione specificate.The EventLogInstaller class does not modify the configuration properties of an existing source to match the specified installation properties. Il Install metodo genera un'eccezione se la Source proprietà corrisponde a un nome di origine registrato per un registro eventi diverso nel computer.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. Il Install metodo non registra l'origine se la Source proprietà corrisponde a un nome di origine già registrato per lo stesso registro Log eventi specificato nella proprietà.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.

È possibile registrare l'origine evento con i file di risorse localizzati per la categoria di eventi e le stringhe di messaggio.You can register the event source with localized resource files for your event category and message strings. L'applicazione può scrivere voci del registro eventi usando gli identificatori di risorsa, anziché specificare la stringa effettiva.Your application can write event log entries using resource identifiers, rather than specifying the actual string. Il Visualizzatore eventi usa l'identificatore di risorsa per trovare e visualizzare la stringa corrispondente dal file di risorse localizzato in base alle impostazioni della lingua corrente.The Event Viewer uses the resource identifier to find and display the corresponding string from the localized resource file based on current language settings. È possibile registrare un file separato per le categorie di eventi, i messaggi e le stringhe di inserimento dei parametri oppure è possibile registrare lo stesso file di risorse per tutti e tre i tipi di stringhe.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. Utilizzare le CategoryCountproprietà CategoryResourceFile, MessageResourceFile, eParameterResourceFile per configurare l'origine per la scrittura di voci localizzate nel registro eventi.Use the CategoryCount, CategoryResourceFile, MessageResourceFile, and ParameterResourceFile properties to configure the source to write localized entries to the event log. Se l'applicazione scrive valori di stringhe direttamente nel registro eventi, non è necessario impostare queste proprietà.If your application writes strings values directly to the event log, you do not need to set these properties.

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette.The source must be configured either for writing localized entries or for writing direct strings. Se l'applicazione scrive voci usando sia gli identificatori di risorsa che i valori di stringa, è necessario registrare due origini separate.If your application writes entries using both resource identifiers and string values, you must register two separate sources. Ad esempio, configurare un'origine con i file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere le voci usando gli identificatori di risorsa nel registro eventi.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. Creare un'origine diversa senza file di risorse e quindi usare tale origine nel WriteEntry metodo per scrivere le stringhe direttamente nel registro eventi usando tale origine.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.

In genere, non è possibile chiamare i metodi della EventLogInstaller classe dall'interno del codice. vengono in genere chiamati solo da 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. Lo strumento chiama automaticamente il Install metodo durante il processo di installazione.The tool automatically calls the Install method during the installation process. Se necessario, esegue il backup degli errori chiamando il Rollback metodo per l'oggetto che ha generato l'eccezione.It backs out failures, if necessary, by calling the Rollback method for the object that generated the exception.

Costruttori

EventLogInstaller() EventLogInstaller() EventLogInstaller() EventLogInstaller()

Inizializza una nuova istanza della classe EventLogInstaller.Initializes a new instance of the EventLogInstaller class.

Proprietà

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
CategoryCount CategoryCount CategoryCount CategoryCount

Ottiene o imposta il numero di categorie nel file di risorse di categoria.Gets or sets the number of categories in the category resource file.

CategoryResourceFile CategoryResourceFile CategoryResourceFile CategoryResourceFile

Ottiene o imposta il percorso del file di risorse che contiene le stringhe di categoria per l'origine.Gets or sets the path of the resource file that contains category strings for the source.

Container Container Container Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Inherited from Component)
Context Context Context Context

Ottiene o imposta le informazioni sull'installazione corrente.Gets or sets information about the current installation.

(Inherited from Installer)
DesignMode DesignMode DesignMode DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
HelpText HelpText HelpText HelpText

Ottiene il testo della Guida per tutti i programmi di installazione dell'insieme Installer.Gets the help text for all the installers in the installer collection.

(Inherited from Installer)
Installers Installers Installers Installers

Ottiene l'insieme dei programmi di installazione contenuti nel programma.Gets the collection of installers that this installer contains.

(Inherited from Installer)
Log Log Log Log

Ottiene o imposta il nome del log sul quale impostare l'origine.Gets or sets the name of the log to set the source to.

MessageResourceFile MessageResourceFile MessageResourceFile MessageResourceFile

Ottiene o imposta il percorso del file di risorse che contiene le stringhe di formattazione del messaggio per l'origine.Gets or sets the path of the resource file that contains message formatting strings for the source.

ParameterResourceFile ParameterResourceFile ParameterResourceFile ParameterResourceFile

Ottiene o imposta il percorso del file di risorse che contiene le stringhe dei parametri di messaggio per l'origine.Gets or sets the path of the resource file that contains message parameter strings for the source.

Parent Parent Parent Parent

Ottiene o imposta il programma di installazione contenente l'insieme cui appartiene questo programma di installazione.Gets or sets the installer containing the collection that this installer belongs to.

(Inherited from Installer)
Site Site Site Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Inherited from Component)
Source Source Source Source

Ottiene o imposta il nome origine da registrare con il log.Gets or sets the source name to register with the log.

UninstallAction UninstallAction UninstallAction UninstallAction

Ottiene o imposta un valore che indica se lo Installutil.exe (Strumento Programma di installazione) deve rimuovere il log eventi o lasciarlo installato al momento della disinstallazione.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.

Metodi

Commit(IDictionary) Commit(IDictionary) Commit(IDictionary) Commit(IDictionary)

Quando sottoposto a override in una classe derivata, completa la transazione di installazione.When overridden in a derived class, completes the install transaction.

(Inherited from Installer)
CopyFromComponent(IComponent) CopyFromComponent(IComponent) CopyFromComponent(IComponent) CopyFromComponent(IComponent)

Copia i valori di proprietà di un componente EventLog necessari in fase di installazione per un log eventi.Copies the property values of an EventLog component that are required at installation time for an event log.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Install(IDictionary) Install(IDictionary) Install(IDictionary) Install(IDictionary)

Esegue l'installazione e inserisce nel Registro di sistema le informazioni relative al log eventi.Performs the installation and writes event log information to the registry.

IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller)

Stabilisce se un programma di installazione e un altro programma di installazione specificato fanno riferimento alla stessa origine.Determines whether an installer and another specified installer refer to the same source.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnAfterInstall(IDictionary) OnAfterInstall(IDictionary) OnAfterInstall(IDictionary) OnAfterInstall(IDictionary)

Genera l'evento AfterInstall.Raises the AfterInstall event.

(Inherited from Installer)
OnAfterRollback(IDictionary) OnAfterRollback(IDictionary) OnAfterRollback(IDictionary) OnAfterRollback(IDictionary)

Genera l'evento AfterRollback.Raises the AfterRollback event.

(Inherited from Installer)
OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary)

Genera l'evento AfterUninstall.Raises the AfterUninstall event.

(Inherited from Installer)
OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary)

Genera l'evento BeforeInstall.Raises the BeforeInstall event.

(Inherited from Installer)
OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary)

Genera l'evento BeforeRollback.Raises the BeforeRollback event.

(Inherited from Installer)
OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary)

Genera l'evento BeforeUninstall.Raises the BeforeUninstall event.

(Inherited from Installer)
OnCommitted(IDictionary) OnCommitted(IDictionary) OnCommitted(IDictionary) OnCommitted(IDictionary)

Genera l'evento Committed.Raises the Committed event.

(Inherited from Installer)
OnCommitting(IDictionary) OnCommitting(IDictionary) OnCommitting(IDictionary) OnCommitting(IDictionary)

Genera l'evento Committing.Raises the Committing event.

(Inherited from Installer)
Rollback(IDictionary) Rollback(IDictionary) Rollback(IDictionary) Rollback(IDictionary)

Ripristina lo stato del computer precedente l'installazione, ripristinando le informazioni del log eventi scritte nel Registro di sistema durante la procedura di installazione.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() ToString() ToString() ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Inherited from Component)
Uninstall(IDictionary) Uninstall(IDictionary) Uninstall(IDictionary) Uninstall(IDictionary)

Rimuove un'installazione eliminando le informazioni sul log eventi dal Registro di sistema.Removes an installation by removing event log information from the registry.

Eventi

AfterInstall AfterInstall AfterInstall AfterInstall

Viene generato dopo l'esecuzione dei metodi Install(IDictionary) di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after the Install(IDictionary) methods of all the installers in the Installers property have run.

(Inherited from Installer)
AfterRollback AfterRollback AfterRollback AfterRollback

Si verifica dopo il rollback delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after the installations of all the installers in the Installers property are rolled back.

(Inherited from Installer)
AfterUninstall AfterUninstall AfterUninstall AfterUninstall

Viene generato dopo l'esecuzione delle operazioni di disinstallazione di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after all the installers in the Installers property perform their uninstallation operations.

(Inherited from Installer)
BeforeInstall BeforeInstall BeforeInstall BeforeInstall

Si verifica dopo l'esecuzione del metodo Install(IDictionary) di ogni programma di installazione contenuto nella raccolta Installer.Occurs before the Install(IDictionary) method of each installer in the installer collection has run.

(Inherited from Installer)
BeforeRollback BeforeRollback BeforeRollback BeforeRollback

Viene generato prima del rollback dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property are rolled back.

(Inherited from Installer)
BeforeUninstall BeforeUninstall BeforeUninstall BeforeUninstall

Viene generato prima dell'esecuzione delle operazioni di disinstallazione dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property perform their uninstall operations.

(Inherited from Installer)
Committed Committed Committed Committed

Si verifica dopo l'esecuzione del commit delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after all the installers in the Installers property have committed their installations.

(Inherited from Installer)
Committing Committing Committing Committing

Si verifica prima dell'esecuzione del commit delle installazioni dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property commit their installations.

(Inherited from Installer)
Disposed Disposed Disposed Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Si applica a

Vedi anche