EventLogTraceListener 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í.
Proporciona un agente de escucha simple que dirige el resultado de la traza o la depuración a EventLog.
public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListenerpublic sealed class EventLogTraceListener : System.Diagnostics.TraceListenertype EventLogTraceListener = class
inherit TraceListenerPublic NotInheritable Class EventLogTraceListener
Inherits TraceListener- Herencia
Ejemplos
En el ejemplo siguiente se crea un agente de escucha de seguimiento que envía la salida a un registro de eventos. En primer lugar, el código crea un nuevo EventLogTraceListener que usa el origen myEventLogSource. A continuación, myTraceListener se agrega a la Trace.Listeners colección . Por último, el ejemplo envía una línea de salida al Listeners objeto .
int main()
{
#if defined(TRACE)
// Create a trace listener for the event log.
EventLogTraceListener^ myTraceListener =
gcnew EventLogTraceListener( "myEventLogSource" );
// Add the event log trace listener to the collection.
Trace::Listeners->Add( myTraceListener );
// Write output to the event log.
Trace::WriteLine( "Test output" );
#endif
}
// Create a trace listener for the event log.
EventLogTraceListener myTraceListener = new EventLogTraceListener("myEventLogSource");
// Add the event log trace listener to the collection.
Trace.Listeners.Add(myTraceListener);
// Write output to the event log.
Trace.WriteLine("Test output");
Overloads Public Shared Sub Main(args() As String)
' Create a trace listener for the event log.
Dim myTraceListener As New EventLogTraceListener("myEventLogSource")
' Add the event log trace listener to the collection.
Trace.Listeners.Add(myTraceListener)
' Write output to the event log.
Trace.WriteLine("Test output")
End Sub
Comentarios
Una instancia de se EventLogTraceListener puede agregar a las Debug.Listenerscolecciones , Trace.Listenerso TraceSource.Listeners para enviar resultados de seguimiento o depuración a .EventLog Puede agregar la instancia en el código o, para una aplicación de .NET Framework, especificarla en el archivo de configuración de la aplicación.
Para agregar un EventLogTraceListener mediante un archivo de configuración de aplicaciones de .NET Framework, edite el archivo que corresponde al nombre de la aplicación. En este archivo, inserte un elemento para un System.Diagnostics.EventLogTraceListener tipo. En el ejemplo siguiente se agrega un EventLogTraceListener objeto denominado myListener a la Trace.Listeners colección . El initializeData parámetro especifica el nombre del origen del registro de eventos que se va a pasar al EventLogTraceListener(String) constructor.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="myListener"
type="System.Diagnostics.EventLogTraceListener"
initializeData="TraceListenerLog" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Nota
Si el Source para el registro de eventos asociado a la EventLogTraceListener instancia no existe, se crea un nuevo origen de eventos. Para crear un origen de eventos en Windows Vista, Windows XP Professional o Windows Server 2003, debe tener privilegios administrativos.
El motivo de este requisito es que se deben buscar todos los registros de eventos, incluida la seguridad, para determinar si el origen del evento es único. En Windows Vista, los usuarios no tienen permiso para acceder al registro de seguridad; por lo tanto, se produce una SecurityException excepción .
En Windows Vista, el control de cuentas de usuario (UAC) determina los privilegios de un usuario. Si es miembro del grupo Administradores integrados, se le asignarán dos símbolos (tokens) de acceso en tiempo de ejecución: un símbolo (token) de acceso de usuario estándar y un símbolo (token) de acceso de administrador. De forma predeterminada, se le asignará el rol de usuario estándar. Para ejecutar el código que accede al registro de seguridad, primero debe elevar los privilegios del usuario estándar al administrador. Para ello, inicie una aplicación haciendo clic con el botón derecho en el icono de la aplicación e indique que desea ejecutarla como administrador.
La clase proporciona la EventLog propiedad para obtener o establecer el registro de eventos que recibe la salida de seguimiento o depuración, y la Name propiedad para contener el nombre de EventLogTraceListener.
El Close método cierra el registro de eventos para que ya no reciba la salida de seguimiento o depuración. Los Write métodos y WriteLine escriben un mensaje en el registro de eventos.
Nota
Para evitar la posibilidad de escribir grandes cantidades de datos en el registro de eventos, no EventLogTraceListener genera los datos de seguimiento opcionales especificados por la TraceOutputOptions propiedad .
Constructores
| EventLogTraceListener() |
Inicializa una nueva instancia de la clase EventLogTraceListener sin un agente de escucha de seguimiento. |
| EventLogTraceListener(EventLog) |
Inicializa una nueva instancia de la clase EventLogTraceListener utilizando el registro de eventos especificado. |
| EventLogTraceListener(String) |
Inicializa una nueva instancia de la clase EventLogTraceListener utilizando el origen especificado. |
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) |
| EventLog |
Obtiene o establece el registro de eventos donde se va a escribir. |
| 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. (Heredado de TraceListener) |
| Name |
Obtiene o establece el nombre de este objeto EventLogTraceListener. |
| 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 registro de eventos de forma que dejan de recibirse los resultados de la traza o 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. (Heredado de TraceListener) |
| Flush() |
Cuando se reemplaza en una clase derivada, vacía el búfer de resultados. (Heredado de TraceListener) |
| 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. (Heredado de TraceListener) |
| 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 el registro de eventos. |
| 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. (Heredado de TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Escribe la información de seguimiento, una matriz de objetos de datos y la información de evento en el registro de eventos. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Escribe la información de seguimiento, una matriz de objetos de datos y la información de evento en los resultados específicos del agente de escucha. (Heredado de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha. (Heredado de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Escribe la información de seguimiento, un mensaje y la información de evento en el registro de eventos. |
| 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. (Heredado de TraceListener) |
| 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 el registro de eventos. |
| 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. (Heredado de TraceListener) |
| 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. (Heredado de TraceListener) |
| 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) |
Escribe un mensaje en el registro de eventos para esta instancia. |
| 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) |
Escribe un mensaje en el registro de eventos para esta instancia. |
| 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) |
Se aplica a
Seguridad para subprocesos
Este tipo es seguro para la ejecución de subprocesos.
