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

EventSourceCreationData (Clase)

Representa los valores de configuración utilizados para crear un origen de registro de eventos en el equipo local o un equipo remoto.

System.Object
  System.Diagnostics.EventSourceCreationData

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

type EventSourceCreationData =  class end

El tipo EventSourceCreationData expone los siguientes miembros.

  NombreDescripción
Método públicoEventSourceCreationDataInicializa una nueva instancia de la clase EventSourceCreationData con un origen de eventos y un nombre de registro de eventos especificados.
Arriba

  NombreDescripción
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úblicaLogNameObtiene o establece el nombre del registro de eventos en el que el origen escribe las entradas.
Propiedad públicaMachineNameObtiene o establece el nombre del equipo en el que se va a registrar el origen de eventos.
Propiedad públicaMessageResourceFileObtiene o establece la ruta de acceso al archivo de recursos de mensaje que contiene las cadenas de formato de mensajes del 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úblicaSourceObtiene o establece el nombre que se va a registrar con el registro de eventos como origen de eventos.
Arriba

  NombreDescripción
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

Utilice la clase EventSourceCreationData para configurar un nuevo origen a fin de escribir las entradas adaptadas en un registro de eventos. No es necesario usar esta clase para leer a partir de un registro de eventos.

Esta clase define los valores de configuración de un nuevo origen de eventos y su registro de eventos asociado. Este registro de eventos puede estar en el equipo local o un equipo remoto. Con el fin de crear un nuevo origen para un registro de eventos nuevo o existente en el equipo local, establezca las propiedades LogName y Source de EventSourceCreationData y llame al método EventLog.CreateEventSource(EventSourceCreationData). Este método crea el origen de eventos especificado en la propiedad Source y lo registra para el registro de eventos especificado en LogName. Este comportamiento es parecido a utilizar la clase EventLogInstaller para registrar un origen de eventos de un registro de eventos.

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.

Aunque cada origen sólo puede escribir en un registro de eventos a la vez, la aplicación puede utilizar varios orígenes para escribir en diversos registros de eventos. Por ejemplo, una aplicación podría requerir la configuración de varios orígenes para diferentes registros de eventos o archivos de recursos.

Para cambiar los detalles de configuración de un origen ya existente, será necesario eliminarlo primero para volver a crearlo con la nueva configuración. Si otras aplicaciones o componentes lo estuvieran utilizando, en lugar de eliminarlo, deberá crearse uno nuevo con la configuración actualizada.

El origen de eventos puede registrarse con 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. El método WriteEntry escribe la cadena especificada directamente en el registro de eventos, no utiliza un archivo de recursos de mensajes adaptado. Para escribir eventos mediante archivo de recursos de mensajes adaptado, deberá utilizarse el método WriteEvent.

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. A continuación, se puede crear otro origen sin archivos de recursos y usarlo en el método WriteEntry para escribir cadenas directamente en el registro de eventos.

Nota de la plataforma Windows 98: 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 configuración de un origen de eventos mediante argumentos de la línea de comandos. Los argumentos de entrada especifican el nombre del origen y del registro de eventos, el nombre del equipo y el archivo de recursos de mensajes de eventos. El ejemplo de código comprueba que el origen no entra en conflicto con un origen de eventos existente y, a continuación, crea el nuevo origen de eventos para el registro de eventos especificado.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.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