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

Propiedad EventInstance.CategoryId

 

Publicado: octubre de 2016

Obtiene o establece el identificador de recursos que especifica la categoría definida por la aplicación de la entrada de evento.

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

member CategoryId : int with get, set

Valor de propiedad

Type: System.Int32

Un categoría numérica valor o identificador de recurso que corresponde a una cadena definida en el archivo de recursos de categoría del origen del evento. El valor predeterminado es cero, lo que significa que no se mostrará ninguna categoría para la entrada de evento.

Exception Condition
ArgumentOutOfRangeException

La propiedad se establece en un valor negativo o un valor mayor que UInt16.MaxValue.

Categorías de registro de eventos son valores definidos por la aplicación que ayudan a filtrar eventos o proporcionan información adicional acerca del evento. Por ejemplo, la aplicación puede definir categorías distintas para componentes diferentes o diferentes operaciones.

Establecer el CategoryId propiedad para especificar la categoría que muestra el Visor de eventos para la entrada. El Visor de eventos puede mostrar la categoría como un valor numérico, o puede usar el CategoryId como un recurso de identificador para mostrar una cadena de categoría adaptada basado en la configuración de idioma actual.

Para mostrar cadenas de categoría adaptadas en el Visor de eventos, debe utilizar un origen de eventos configurado con un archivo de recursos de categorías y establecer el CategoryId a un identificador de recurso en el archivo de recursos de categoría. Si el origen del evento no tiene un archivo de recursos de categoría configurado o especificado CategoryId no índice una cadena en el archivo de recursos de categoría y, a continuación, en el Visor de eventos muestra el valor numérico de categoría para esa entrada.

Debe registrar el origen con el archivo de recursos correspondiente antes de escribir categorías de eventos con identificadores de recursos. Configurar el archivo de recursos de categoría, junto con el número de cadenas de categoría en el archivo de recursos utilizando el EventLogInstaller o la EventSourceCreationData clase. Al definir las cadenas de categoría en un archivo de recursos, los identificadores de recursos de categoría deben estar numerados consecutivamente, desde 1 hasta configurado CategoryCount valor de propiedad.

Categorías de eventos son opcionales. Si su aplicación no utiliza categorías, no establezca la CategoryId para la entrada de registro de eventos.

Para obtener información sobre cómo definir mensajes de eventos y generación de archivos de recursos de evento, consulte el tema "Compilador de mensajes" en la documentación de Platform SDK en http://msdn.microsoft.com. Para obtener más información acerca de la definición de categorías de eventos en archivos de recursos, consulte el tema "Categorías de eventos" en el SDK de plataforma

En el ejemplo de código siguiente se escribe una entrada de evento informativa y, a continuación, se reutiliza el EventInstance para escribir una entrada para un evento de advertencia en un registro de eventos existente. El texto del mensaje de evento se especifica mediante un identificador de recursos en un archivo de recursos de mensaje. El ejemplo de código se supone que se ha registrado el correspondiente archivo de recursos de mensaje para el origen.

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

El ejemplo de código utiliza el siguiente archivo de texto de mensaje, integrado en la biblioteca de recursos EventLogMsgs.dll. Un archivo de texto de mensaje es el origen desde el que se creó el archivo de recursos de mensaje. El archivo de texto de mensaje define los identificadores de recursos y el texto de categoría, mensaje de evento y las cadenas de inserción de parámetro.

; // EventLogMsgs.mc
; // ********************************************************

; // Use the following commands to build this file:

; //   mc -s EventLogMsgs.mc
; //   rc EventLogMsgs.rc
; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res 
; // ********************************************************

; // - Event categories -
; // Categories must be numbered consecutively starting at 1.
; // ********************************************************

MessageId=0x1
Severity=Success
SymbolicName=INSTALL_CATEGORY
Language=English
Installation
.

MessageId=0x2
Severity=Success
SymbolicName=QUERY_CATEGORY
Language=English
Database Query
.

MessageId=0x3
Severity=Success
SymbolicName=REFRESH_CATEGORY
Language=English
Data Refresh
.

; // - Event messages -
; // *********************************

MessageId = 1000
Severity = Success
Facility = Application
SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000
Language=English
My application message text, in English, for message id 1000, called from %1.
.

MessageId = 1001
Severity = Warning
Facility = Application
SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001
Language=English
My application message text, in English, for message id 1001, called from %1.
.


MessageId = 1002
Severity = Success
Facility = Application
SymbolicName = GENERIC_INFO_MESSAGE_ID_1002
Language=English
My generic information message in English, for message id 1002.
.


MessageId = 1003
Severity = Warning
Facility = Application
SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003
Language=English
My generic warning message in English, for message id 1003, called from %1.
.


MessageId = 1004
Severity = Success
Facility = Application
SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004
Language=English
The update cycle is complete for %%5002.
.


MessageId = 1005
Severity = Warning
Facility = Application
SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005
Language=English
The refresh operation did not complete because the connection to server %1 could not be established.
.


; // - Event log display name -
; // ********************************************************


MessageId = 5001
Severity = Success
Facility = Application
SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID
Language=English
Sample Event Log
.



; // - Event message parameters -
; //   Language independent insertion strings
; // ********************************************************


MessageId = 5002
Severity = Success
Facility = Application
SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID
Language=English
SVC_UPDATE.EXE
.

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: