EventProviderTraceListener Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agente de escucha de TraceSource que escribe los eventos en el subsistema ETW.
public ref class EventProviderTraceListener : System::Diagnostics::TraceListenerpublic class EventProviderTraceListener : System.Diagnostics.TraceListenertype EventProviderTraceListener = class
inherit TraceListenerPublic Class EventProviderTraceListener
Inherits TraceListener- Herencia
Ejemplos
private static Guid providerId = new Guid("{B3F0C8FC-E8A8-4868-8901-1465E8A2F41B}");
EventProviderTraceListener listener = new EventProviderTraceListener(providerId.ToString(), "Test Listener", "::");
// You should use the All default level and control the level using the
// ETW session; otherwise, you may not log all the events requested by the
// session.
TraceSource source = new TraceSource("MyProvider", SourceLevels.All);
source.Listeners.Add(listener);
source.TraceData(TraceEventType.Warning | TraceEventType.Start, 2, new object[] { "abc", "def", true, 123 });
source.TraceEvent(TraceEventType.Warning, 12, "Provider guid: {0}", new object[] { providerId });
source.TraceInformation("string {0}, bool {1}, int {2}, ushort {3}", new object[] { "abc", false, 123, (UInt32)5 });
Comentarios
Todos los datos de eventos (seguimiento o depuración) del evento de origen se escriben en el subsistema ETW como una cadena. Los elementos de datos se delimitan mediante una coma. Para especificar un delimitador diferente, use la Delimiter propiedad .
Al agregar el agente de escucha para System.Diagnostics.TraceSource registrar el proveedor con el subsistema ETW. Debe crear una sesión de seguimiento ETW mediante el programa ejecutable Logman.exe (o algo similar) para escribir los eventos en un archivo de registro.
No necesita un manifiesto para consumir eventos del agente de escucha porque los datos del evento son una sola cadena.
Al llamar a los System.Diagnostics.TraceSource métodos para escribir eventos, se pasa un System.Diagnostics.TraceEventType valor de enumeración. La enumeración contiene valores de nivel y palabra clave. Al habilitar un proveedor de escucha de seguimiento desde una sesión ETW, el valor de nivel que especifique puede ser el valor asociado a uno de los siguientes System.Diagnostics.TraceEventType valores de enumeración:
Crítico (el valor es 1)
Error (el valor es 2)
Información (el valor es 8)
Detallado (el valor es 16)
Advertencia (el valor es 4)
El valor de palabra clave que especifique para la sesión puede ser el valor asociado a uno de los siguientes System.Diagnostics.TraceEventType valores de enumeración:
Reanudar (el valor es 2048)
Inicio (el valor es 256)
Stop (el valor es 512)
Suspender (el valor es 1024)
Transferencia (el valor es 4096)
Constructores
| EventProviderTraceListener(String) |
Inicializa una nueva instancia de la clase EventProviderTraceListener utilizando el identificador de proveedor especificado. |
| EventProviderTraceListener(String, String) |
Inicializa una nueva instancia de la clase EventProviderTraceListener mediante el identificador de proveedor y el nombre del agente de escucha especificados. |
| EventProviderTraceListener(String, String, String) |
Inicializa una nueva instancia de la clase EventProviderTraceListener mediante el identificador de proveedor, el nombre del agente de escucha y el delimitador especificados. |
Propiedades
| Attributes |
Obtiene los atributos de agente de escucha de seguimiento personalizados que están definidos en el archivo de configuración de la aplicación. (Heredado de TraceListener) |
| Delimiter |
Obtiene o establece el delimitador usado para delimitar los datos de eventos que se escriben en el subsistema ETW. |
| Filter |
Obtiene o establece el filtro de seguimiento para el agente de escucha de seguimiento. (Heredado de TraceListener) |
| IndentLevel |
Obtiene o establece el nivel de sangría. (Heredado de TraceListener) |
| IndentSize |
Obtiene o establece el número de espacios de una sangría. (Heredado de TraceListener) |
| IsThreadSafe |
Obtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos. |
| Name |
Obtiene o establece un nombre para este objeto TraceListener. (Heredado de TraceListener) |
| NeedIndent |
Obtiene o establece un valor que indica si se va a aplicar sangría a los resultados. (Heredado de TraceListener) |
| TraceOutputOptions |
Obtiene o establece las opciones de los resultados de seguimiento. (Heredado de TraceListener) |
Métodos
| Close() |
Cierra el flujo de salida para que ya no reciba resultados de la traza o de la depuración. |
| CreateObjRef(Type) |
Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject) |
| Dispose() |
Libera todos los recursos que usa TraceListener. (Heredado de TraceListener) |
| Dispose(Boolean) |
Libera los recursos no administrados que usa TraceListener y, de forma opcional, libera los recursos administrados. (Heredado de TraceListener) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| Fail(String) |
Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener. (Heredado de TraceListener) |
| Fail(String, String) |
Emite un mensaje de error y un mensaje de error detallado para el agente de escucha que se crea al implementar la clase TraceListener. |
| Flush() |
Vacía el búfer de salida. |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetLifetimeService() |
Obsoletos.
Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject) |
| GetSupportedAttributes() |
Obtiene los atributos personalizados admitidos por el agente de escucha de seguimiento. |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| InitializeLifetimeService() |
Obsoletos.
Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Escribe la información de seguimiento, un objeto de datos y la información de evento en los resultados específicos del agente de escucha. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Escribe la información de seguimiento, un objeto de datos y la información de evento en los resultados específicos del agente de escucha. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Escribe la información de seguimiento, un mensaje y la información de evento en los resultados específicos del agente de escucha. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Escribe la información de seguimiento, una matriz de objetos con formato y la información de evento en los resultados específicos del agente de escucha. |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Escribe la información de seguimiento, un mensaje, una identidad de actividad relacionada y la información de evento en los resultados específicos del agente de escucha. |
| Write(Object) |
Escribe el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener. (Heredado de TraceListener) |
| Write(Object, String) |
Escribe un nombre de categoría y el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener. (Heredado de TraceListener) |
| Write(String) |
Cuando se reemplaza en una clase derivada, escribe el mensaje especificado en el agente de escucha que se crea en la clase derivada. |
| Write(String, String) |
Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener. (Heredado de TraceListener) |
| WriteIndent() |
Escribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en |
| WriteLine(Object) |
Escribe el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguido de un terminador de línea. (Heredado de TraceListener) |
| WriteLine(Object, String) |
Escribe un nombre de categoría y el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguidos de un terminador de línea. (Heredado de TraceListener) |
| WriteLine(String) |
Cuando se reemplaza en una clase derivada, escribe un mensaje en el agente de escucha que se crea en la clase derivada, seguido de un terminador de línea. |
| WriteLine(String, String) |
Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener, seguidos de un terminador de línea. (Heredado de TraceListener) |
