Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase EventSourceCreationData

 

Publicado: octubre de 2016

Representa la configuración utilizada para crear un origen de registro de eventos en el equipo local o un equipo remoto.

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

System.Object
  System.Diagnostics.EventSourceCreationData

type EventSourceCreationData = class end

NombreDescripción
System_CAPS_pubmethodEventSourceCreationData(String, String)

Inicializa una nueva instancia de la EventSourceCreationData clase con un nombre de origen y el registro de eventos del evento especificado.

NombreDescripción
System_CAPS_pubpropertyCategoryCount

Obtiene o establece el número de categorías en el archivo de recursos de categoría.

System_CAPS_pubpropertyCategoryResourceFile

Obtiene o establece la ruta de acceso del archivo de recursos que contiene las cadenas de categoría para el origen.

System_CAPS_pubpropertyLogName

Obtiene o establece el nombre del registro de eventos en el que el origen escribe las entradas.

System_CAPS_pubpropertyMachineName

Obtiene o establece el nombre del equipo en el que se va a registrar el origen del evento.

System_CAPS_pubpropertyMessageResourceFile

Obtiene o establece la ruta de acceso del archivo de recursos de mensaje que contiene el formato de cadenas para el origen del mensaje.

System_CAPS_pubpropertyParameterResourceFile

Obtiene o establece la ruta de acceso del archivo de recursos que contiene cadenas de parámetros de mensaje para el origen.

System_CAPS_pubpropertySource

Obtiene o establece el nombre para registrar con el registro de eventos como origen de eventos.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

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

Esta clase define las opciones de configuración para un nuevo origen de eventos y su registro de eventos asociado. El registro de eventos asociado puede estar en el equipo local o un equipo remoto. Para crear un nuevo origen para un registro de eventos nuevo o existente en el equipo local, establezca el LogName y Source Propiedades de un EventSourceCreationData y llamar a la EventLog.CreateEventSource(EventSourceCreationData) (método). Este método crea el origen de eventos especificado en el Source propiedad y se registra para el registro de eventos especificado en LogName. Este comportamiento es similar al uso de la EventLogInstaller clase para registrar un origen de eventos para un registro de eventos.

Utilice la WriteEvent y WriteEntry métodos para escribir eventos en un registro de eventos. Debe especificar un origen de eventos para escribir los eventos; debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen.

Crear el nuevo origen de eventos durante la instalación de la aplicación. Esto da tiempo para el sistema operativo actualizar la lista de orígenes de eventos registrados y sus configuraciones. Si el sistema operativo no ha actualizado su lista de orígenes de eventos y se intenta escribir un evento con el nuevo origen, que se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante un EventLogInstaller, o mediante el CreateEventSource método. Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

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

Cada origen sólo puede escribir en un registro de eventos a la vez; Sin embargo, la aplicación puede utilizar varios orígenes para escribir en varios registros de eventos. Por ejemplo, su aplicación podría tener varios orígenes configurados para diferentes registros de eventos o archivos de recursos.

Para cambiar los detalles de configuración de un origen existente, debe eliminar el origen y, a continuación, vuelva a crearla con la nueva configuración. Si otras aplicaciones o componentes utilizan el origen existente, crear un nuevo origen con la configuración actualizada en lugar de eliminarlo.

Puede registrar el origen de eventos con los recursos localizados para las cadenas de categoría y el mensaje de evento. La aplicación puede escribir entradas del registro de eventos con identificadores de recursos, en lugar de especificar la cadena real. El Visor de eventos utiliza el identificador del recurso para buscar y mostrar la cadena correspondiente del archivo de recursos localizados según la configuración de idioma actual. Puede registrarse un archivo independiente para las categorías de eventos, mensajes y las cadenas de inserción de parámetro, o puede registrar el mismo archivo de recursos para los tres tipos de cadenas. Utilice la CategoryCount, CategoryResourceFile, MessageResourceFile, y ParameterResourceFile Propiedades para configurar el origen para escribir entradas adaptadas en el registro de eventos. Si la aplicación escribe valores de cadena directamente en el registro de eventos, no es necesario establecer estas propiedades.

El origen debe configurarse para escribir entradas adaptadas o cadenas directas. El WriteEntry método escribe la cadena especificada directamente en el registro de eventos; no utiliza un archivo de recursos de mensaje localizable. Utilice la WriteEvent método para escribir eventos mediante un archivo de recursos de mensaje adaptado.

Si la aplicación escribe las entradas mediante identificadores de recursos y valores de cadena, debe registrarse dos orígenes diferentes. Por ejemplo, configurar un origen con archivos de recursos y, a continuación, usar ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. A continuación, cree un origen diferente sin archivos de recursos y usarlo en el WriteEntry método para escribir cadenas directamente en el registro de eventos utilizando ese origen.

Win98

Event logs are not supported on Windows 98/Windows Millennium Edition (Me).

El ejemplo de código siguiente establece las propiedades de configuración para un origen de eventos de los argumentos de línea de comandos. Los argumentos de entrada especifican el nombre del origen de evento, nombre de registro de eventos, nombre de equipo y archivo de recursos de mensaje de evento. El ejemplo de código se 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.

SecurityPermission

for calling any member of T:System.Diagnostics.EventSourceCreationData with full trust. Associated enumeration: F:System.Security.Permissions.PermissionState.Unrestricted

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: