Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

EventLogInstaller (Clase)

Permite instalar y configurar un registro de eventos en el que la aplicación lee o escribe cuando se ejecuta.

Espacio de nombres:  System.Diagnostics
Ensamblado:  System.Configuration.Install (en System.Configuration.Install.dll)

public ref class EventLogInstaller : public ComponentInstaller

El tipo EventLogInstaller expone los siguientes miembros.

  NombreDescripción
Método públicoEventLogInstallerInicializa una nueva instancia de la clase EventLogInstaller.
Arriba

  NombreDescripción
Propiedad protegidaCanRaiseEventsObtiene un valor que indica si el componente puede generar un evento. (Se hereda de Component).
Propiedad públicaCategoryCountObtiene o establece el número de categorías en el archivo de recursos de categoría.
Propiedad públicaCategoryResourceFileObtiene o establece la ruta de acceso del archivo de recursos que contiene las cadenas de categoría para el origen.
Propiedad públicaContainerObtiene IContainer que contiene Component. (Se hereda de Component).
Propiedad públicaContextObtiene o establece información sobre la instalación actual. (Se hereda de Installer).
Propiedad protegidaDesignModeObtiene un valor que indica si Component está actualmente en modo de diseño. (Se hereda de Component).
Propiedad protegidaEventsObtiene la lista de controladores de eventos asociados a Component. (Se hereda de Component).
Propiedad públicaHelpTextObtiene el texto de ayuda de todos los instaladores que se encuentran en la colección de instaladores. (Se hereda de Installer).
Propiedad públicaInstallersObtiene la colección de instaladores que contiene este instalador. (Se hereda de Installer).
Propiedad públicaLogObtiene o establece el nombre del registro en el que hay que establecer el origen.
Propiedad públicaMessageResourceFileObtiene o establece la ruta de acceso del archivo de recursos que contiene las cadenas de formato de mensaje para el origen.
Propiedad públicaParameterResourceFileObtiene o establece la ruta de acceso del archivo de recursos que contiene las cadenas de parámetros de mensaje para el origen.
Propiedad públicaParentObtiene o establece el instalador que contiene la colección a la que pertenece este instalador. (Se hereda de Installer).
Propiedad públicaSiteObtiene o establece ISite de Component. (Se hereda de Component).
Propiedad públicaSourceObtiene o establece el nombre del origen que se va a registrar con el registro.
Propiedad públicaUninstallActionObtiene o establece un valor que indica si Installutil.exe (Herramienta Installer) debe quitar el registro de eventos o dejarlo en su estado instalado, en el momento de la desinstalación.
Arriba

  NombreDescripción
Método públicoCommitCuando se reemplaza en una clase derivada, finaliza la transacción de instalación. (Se hereda de Installer).
Método públicoCopyFromComponentCopia los valores de propiedad de un componente EventLog que se necesitan durante la instalación para un registro de eventos. (Invalida a ComponentInstaller::CopyFromComponent(IComponent)).
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoDispose()Libera todos los recursos utilizados por Component. (Se hereda de Component).
Método protegidoDispose(Boolean)Libera los recursos no administrados que utiliza Component y libera los recursos administrados de forma opcional. (Se hereda de Component).
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalizeLibera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recolección de elementos no utilizados. (Se hereda de Component).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoGetServiceDevuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método públicoInstallRealiza la instalación y escribe la información del registro de eventos en el Registro. (Invalida a Installer::Install(IDictionary)).
Método públicoIsEquivalentInstallerDetermina si un instalador y otro instalador especificado hacen referencia al mismo origen. (Invalida a ComponentInstaller::IsEquivalentInstaller(ComponentInstaller)).
Método protegidoMemberwiseClone() Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método protegidoOnAfterInstallGenera el evento AfterInstall. (Se hereda de Installer).
Método protegidoOnAfterRollbackGenera el evento AfterRollback. (Se hereda de Installer).
Método protegidoOnAfterUninstallGenera el evento AfterUninstall. (Se hereda de Installer).
Método protegidoOnBeforeInstallGenera el evento BeforeInstall. (Se hereda de Installer).
Método protegidoOnBeforeRollbackGenera el evento BeforeRollback. (Se hereda de Installer).
Método protegidoOnBeforeUninstallGenera el evento BeforeUninstall. (Se hereda de Installer).
Método protegidoOnCommittedGenera el evento Committed. (Se hereda de Installer).
Método protegidoOnCommittingGenera el evento Committing. (Se hereda de Installer).
Método públicoRollbackRestaura el equipo al estado que tenía antes de la instalación, deshaciendo la información del registro de eventos que el procedimiento de instalación escribió en el Registro. (Invalida a Installer::Rollback(IDictionary)).
Método públicoToStringDevuelve un objeto String que contiene el nombre del objeto Component, en caso de que exista. Este método no debe reemplazarse. (Se hereda de Component).
Método públicoUninstallQuita una instalación suprimiendo la información del registro de eventos del Registro. (Invalida a Installer::Uninstall(IDictionary)).
Arriba

  NombreDescripción
Evento públicoAfterInstallSe produce después de ejecutarse los métodos Install de todos los instaladores de la propiedad Installers. (Se hereda de Installer).
Evento públicoAfterRollbackSe produce después de deshacerse la instalación de todos los instaladores de la propiedad Installers. (Se hereda de Installer).
Evento públicoAfterUninstallSe produce después de que todos los instaladores de la propiedad Installers realicen sus operaciones de desinstalación. (Se hereda de Installer).
Evento públicoBeforeInstallSe produce antes de ejecutarse el método Install de cada instalador en la colección de instaladores. (Se hereda de Installer).
Evento públicoBeforeRollbackSe produce antes de deshacerse los instaladores de la propiedad Installers. (Se hereda de Installer).
Evento públicoBeforeUninstallSe produce antes de que los instaladores de la propiedad Installers realicen sus operaciones de desinstalación. (Se hereda de Installer).
Evento públicoCommittedSe produce después de que todos los instaladores de la propiedad Installers confirmen sus instalaciones. (Se hereda de Installer).
Evento públicoCommittingSe produce antes de que los instaladores de la propiedad Installers confirmen sus instalaciones. (Se hereda de Installer).
Evento públicoDisposedSe produce cuando el componente se elimina mediante una llamada al método Dispose. (Se hereda de Component).
Arriba

Installutil.exe (Herramienta Installer) utiliza la clase EventLogInstaller cuando se instala un registro de eventos. La clase EventLogInstaller sólo puede instalar registros de eventos en el equipo local.

Utilice la clase EventLogInstaller cuando la aplicación escriba en un registro de eventos; no es necesario utilizar un instalador de registro de eventos para que la aplicación lea un registro de eventos. Las aplicaciones y los servicios deben escribir en el registro de aplicaciones o en un registro personalizado. Los controladores de dispositivos deben escribir en el Registro del sistema.

NotaNota

El registro de seguridad es de sólo lectura.

El instalador crea el origen de eventos especificado en la propiedad Source y lo registra para el registro de eventos especificado en la propiedad Log. Este comportamiento es muy parecido a llamar a CreateEventSource en el componente EventLog.

Utilice los métodos WriteEvent y WriteEntry para escribir eventos en un registro de eventos. Para escribir eventos, es necesario especificar un origen de eventos; asimismo, antes de escribir la primera entrada con el origen, es necesario crearlo y configurarlo.

El nuevo origen de eventos deberá crearse durante la instalación de la aplicación. De esta manera, el sistema operativo dispondrá de tiempo para actualizar la lista de orígenes de eventos registrados y sus configuraciones. Si el sistema operativo aún no ha actualizado la lista de orígenes de eventos y se intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Para configurar un nuevo origen, puede utilizarse EventLogInstaller o el método CreateEventSource. Es necesario contar con derechos administrativos en el equipo para crear un nuevo origen de eventos.

Puede crearse un origen de eventos para un registro de eventos ya existente o para uno nuevo. Cuando se crea un origen para un registro de eventos nuevo, el sistema registra el origen de ese registro, pero éste no se crea hasta que no se escriba la primera entrada en él.

Para instalar un registro de eventos, cree una clase de instalador del proyecto que se herede de Installer y establezca RunInstallerAttribute de la clase en true. En el proyecto, cree un objeto EventLogInstaller para cada registro de eventos en el que vaya a escribir la aplicación y agregue la instancia a la clase de instalador del proyecto.

Cuando se llama a Installutil.exe (Herramienta Installer), examina RunInstallerAttribute. Si es true, la herramienta instala todos los elementos de la colección de Installers asociados al instalador del proyecto. Si RunInstallerAttribute es false, la herramienta omite el instalador del proyecto.

El resto de las propiedades de EventLogInstaller se modifica antes o después de agregar la instancia a la colección de Installers del instalador del proyecto, pero antes de ejecutar la herramienta de instalación. Se debe establecer la propiedad Source si la aplicación va a escribir entradas en el registro de eventos.

Utilice EventLogInstaller para registrar un origen nuevo para un registro de eventos nuevo o existente; no utilice EventLogInstaller para cambiar un origen ya existente. La clase EventLogInstaller no modifica las propiedades de configuración de un origen existente para que coincidan con las propiedades de instalación especificadas. El método Install produce una excepción si la propiedad Source coincide con un nombre de origen que ya está registrado para otro registro de eventos del equipo. El método Install no registra el origen si la propiedad Source coincide con un nombre de origen ya registrado para el mismo registro de eventos especificado en la propiedad Log.

El origen de eventos puede registrarse con archivos de recursos adaptados para la categoría de eventos y las cadenas de mensaje. Una aplicación puede escribir entradas del registro de eventos mediante identificadores de recursos en lugar de especificar la cadena real. El visor de eventos utiliza el identificador del recurso para buscar y mostrar la correspondiente cadena del archivo de recursos adaptado en función de la configuración de idioma actual. Puede registrarse un archivo independiente para las cadenas de categoría de eventos, mensajes e inserción de parámetros, o bien un mismo archivo de recursos para los tres tipos de cadenas. Las propiedades CategoryCount, CategoryResourceFile, MessageResourceFile y ParameterResourceFile se emplean para configurar un origen para la escritura de entradas adaptadas en el registro de eventos. Cuando una aplicación escribe valores de cadena directamente en el registro de eventos, no es necesario establecer estas propiedades.

El origen deberá configurarse para escribir o bien entradas adaptadas o bien cadenas directas. Cuando una aplicación escriba entradas usando tanto identificadores de recursos como valores de cadena, deberán registrarse dos orígenes diferentes. Por ejemplo, puede configurarse un origen con archivos de recursos y usarlo en el método WriteEvent para escribir entradas en el registro de eventos mediante identificadores de recursos. Cree un origen diferente sin archivos de recursos y, a continuación, utilícelo en el método WriteEntry para escribir cadenas directamente en el registro de eventos utilizando ese origen.

Normalmente, no se llama a los métodos de la clase EventLogInstaller desde el código; se les suele llamar solo desde Installutil.exe. La herramienta llama automáticamente al método Install durante el proceso de instalación. Deshace los errores, si es necesario, mediante una llamada al método Rollback para el objeto que generó la excepción.

Nota de la plataforma : Los registros de eventos no son compatibles con Windows 98 ni Windows Millennium (Me).

En el ejemplo de código siguiente se establecen las propiedades de instalación para un nuevo origen de eventos. El ejemplo de código establece el nombre de origen y el nombre del registro de eventos y agrega EventLogInstaller a la colección de Installers.


#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 );
   }
};


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft