EventSchemaTraceListener EventSchemaTraceListener EventSchemaTraceListener EventSchemaTraceListener Class

Definición

Dirige la salida de trazas o la depuración de eventos de un extremo a otro a un archivo de registro con codificación XML conforme al esquema.Directs tracing or debugging output of end-to-end events to an XML-encoded, schema-compliant log file.

public ref class EventSchemaTraceListener : System::Diagnostics::TextWriterTraceListener
public class EventSchemaTraceListener : System.Diagnostics.TextWriterTraceListener
type EventSchemaTraceListener = class
    inherit TextWriterTraceListener
Public Class EventSchemaTraceListener
Inherits TextWriterTraceListener
Herencia

Ejemplos

En el ejemplo de código siguiente se muestra cómo EventSchemaTraceListener utilizar la clase.The following code example demonstrates how to use the EventSchemaTraceListener class.


///////////////////////////////////////////////////////////////////////
//
// EventSchemaTraceListener.cpp : main project file.
// Expected Output:
// 1)
//      EventSchemaTraceListener CPP Sample
//
//      IsThreadSafe? True
//      BufferSize =  65536
//      MaximumFileSize =  20480000
//      MaximumNumberOfFiles =  2
//      Name =  eventListener
//      TraceLogRetentionOption = LimitedCircularFiles
//      TraceOutputOptions = DateTime, Timestamp, ProcessId
//
//      Press the enter key to exit
//
// 2) An output file is created named TraceOutput.xml.  It will be
//    opened and displayed in Microsoft Notepad.
//
// NOTE 1:
//  Under certain circumstances, the VS C++ compiler will treat
//          Console::WriteLine("MyText = " + MyVar);
//        differently then the VS CSharp compiler.
//        The C++ compiler will produce error C3063, whereas the 
//        CSharp compiler accepts the statement.
//        This occurs when the VS C++ compiler cannot determine the
//        datatype of "MyVar" because it is an enumeration type.
//        The solution is:
//        Use either of the following two methods:
//          Console::WriteLine("MyText = {0} " , MyVar);
//          Console::WriteLine("MyText =  " + MyVar.ToString());
//
//        Although not specific to this particular pieces of code,
//        this is demonstrated below in the Display function:  The
//        last two members, TraceLogRetentionOption, and
//        TraceOutputOptions, are enumerations, and cannot simply be
//        concatenated into Console::WriteLine.
//
///////////////////////////////////////////////////////////////////////
#using <System.dll>
#using <System.Core.dll>

#define NOCONFIGFILE 1
using namespace System;
using namespace System::IO;
using namespace System::Diagnostics;


[STAThreadAttribute]
void main()
{
    Console::WriteLine("EventSchemaTraceListener CPP Sample\n");

    File::Delete("TraceOutput.xml");
    TraceSource ^ ts = gcnew TraceSource("TestSource");


#if NOCONFIGFILE
    ts->Listeners->Add(gcnew EventSchemaTraceListener("TraceOutput.xml",
                            "eventListener", 65536,
                            TraceLogRetentionOption::LimitedCircularFiles,
                            20480000, 2));
    ts->Listeners["eventListener"]->TraceOutputOptions =
                                    TraceOptions::DateTime |
                                    TraceOptions::ProcessId |
                                    TraceOptions::Timestamp;
#endif

    EventSchemaTraceListener ^ ESTL =
               (EventSchemaTraceListener^)(ts->Listeners["eventListener"]);


    Console::WriteLine("IsThreadSafe?            = " + ESTL->IsThreadSafe);
    Console::WriteLine("BufferSize               = " + ESTL->BufferSize);
    Console::WriteLine("MaximumFileSize          = " + ESTL->MaximumFileSize);
    Console::WriteLine("MaximumNumberOfFiles     = " + ESTL->MaximumNumberOfFiles);
    Console::WriteLine("Name                     = " + ESTL->Name);
    Console::WriteLine("TraceLogRetentionOption  = " + ESTL->TraceLogRetentionOption.ToString());
    Console::WriteLine("TraceOutputOptions       = {0}\n", ESTL->TraceOutputOptions);

    ts->Switch->Level = SourceLevels::All;
    String ^ testString = "<Test><InnerElement Val=\"1\" />"
                        + "<InnerElement Val=\"Data\"/>"
                        + "<AnotherElement>11</AnotherElement></Test>";

    UnescapedXmlDiagnosticData ^ unXData = gcnew UnescapedXmlDiagnosticData(testString);
    ts->TraceData(TraceEventType::Error, 38, unXData);
    ts->TraceEvent(TraceEventType::Error, 38, testString);
    ts->Flush();
    ts->Close();

    Process::Start("notepad.exe", "TraceOutput.xml");
    Console::WriteLine("\nPress the enter key to exit");
    Console::ReadLine();
}
#define NOCONFIGFILE
using System;
using System.IO;
using System.Xml;
using System.Xml.XPath;
using System.Diagnostics;

class testClass
{
    [STAThreadAttribute]
    static void Main()
    {
        File.Delete("TraceOutput.xml");
        TraceSource ts = new TraceSource("TestSource");
#if NOCONFIGFILE
        //ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000, 2));
        ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener"));
        ts.Listeners["eventListener"].TraceOutputOptions = TraceOptions.DateTime | TraceOptions.ProcessId | TraceOptions.Timestamp;
#endif
        ts.Switch.Level = SourceLevels.All;
        string testString = "<Test><InnerElement Val=\"1\" /><InnerElement Val=\"Data\"/><AnotherElement>11</AnotherElement></Test>";
        UnescapedXmlDiagnosticData unXData = new UnescapedXmlDiagnosticData(testString);
        ts.TraceData(TraceEventType.Error, 38, unXData);
        ts.TraceEvent(TraceEventType.Error, 38, testString);
        Trace.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml"));
        Trace.Write("test", "test");
        Trace.Flush();
        ts.Flush();
        ts.Close();
        DisplayProperties(ts);
        Process.Start("notepad.exe", "TraceOutput.xml");
        Console.WriteLine("Press the enter key to exit");
        Console.ReadLine();
    }
    private static void DisplayProperties(TraceSource ts)
    {
        Console.WriteLine("IsThreadSafe? " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).IsThreadSafe);
        Console.WriteLine("BufferSize =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).BufferSize);
        Console.WriteLine("MaximumFileSize =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).MaximumFileSize);
        Console.WriteLine("MaximumNumberOfFiles =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).MaximumNumberOfFiles);
        Console.WriteLine("Name =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).Name);
        Console.WriteLine("TraceLogRetentionOption =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).TraceLogRetentionOption);
        Console.WriteLine("TraceOutputOptions =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).TraceOutputOptions);
    }
}
#Const NOCONFIGFILE = True
Imports System.IO
Imports System.Xml
Imports System.Xml.XPath
Imports System.Diagnostics

Class testClass

    <STAThreadAttribute()> _
    Shared Sub Main()
        File.Delete("TraceOutput.xml")
        Dim ts As New TraceSource("TestSource")
#If NOCONFIGFILE Then
        ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000, 2))
        ts.Listeners("eventListener").TraceOutputOptions = TraceOptions.DateTime Or TraceOptions.ProcessId Or TraceOptions.Timestamp
#End If
        ts.Switch.Level = SourceLevels.All
        Dim testString As String = "<Test><InnerElement Val=""1"" /><InnerElement Val=""Data""/><AnotherElement>11</AnotherElement></Test>"
        Dim unXData As New UnescapedXmlDiagnosticData(testString)
        ts.TraceData(TraceEventType.Error, 38, unXData)
        ts.TraceEvent(TraceEventType.Error, 38, testString)
        ts.Flush()
        ts.Close()
        DisplayProperties(ts)
        Process.Start("notepad.exe", "TraceOutput.xml")
        Console.WriteLine("Press the enter key to exit")
        Console.ReadLine()

    End Sub 'Main

    Private Shared Sub DisplayProperties(ByVal ts As TraceSource)
        Console.WriteLine("IsThreadSafe? " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).IsThreadSafe.ToString())
        Console.WriteLine("BufferSize =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).BufferSize.ToString())
        Console.WriteLine("MaximumFileSize =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).MaximumFileSize.ToString())
        Console.WriteLine("MaximumNumberOfFiles =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).MaximumNumberOfFiles.ToString())
        Console.WriteLine("Name =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).Name)
        Console.WriteLine("TraceLogRetentionOption =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).TraceLogRetentionOption.ToString())
        Console.WriteLine("TraceOutputOptions =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).TraceOutputOptions.ToString())
    End Sub
End Class 'testClass

Comentarios

La EventSchemaTraceListener clase proporciona seguimiento de los eventos que cumplen los esquemas de un extremo a otro.The EventSchemaTraceListener class provides tracing of end-to-end schema-compliant events. Puede usar el seguimiento de un extremo a otro para un sistema que tenga componentes heterogéneos que crucen AppDomainlos límites de subprocesos, procesos y equipos.You can use end-to-end tracing for a system that has heterogeneous components that cross thread, AppDomain, process, and computer boundaries. Se ha definido un esquema de eventos normalizado (consulte representación de eventos para los consumidores de eventos) para habilitar el seguimiento en estos límites.A standardized event schema (see Event Representation for Event Consumers) has been defined to enable tracing across these boundaries. El esquema permite agregar elementos personalizados que cumplan el esquema.The schema enables the addition of custom, schema-compliant elements. Puede usar la herramienta Service Trace Viewer (SvcTraceViewer. exe) para mostrar los datos de evento.You can use the Service Trace Viewer Tool (SvcTraceViewer.exe) to display the event data.

EventSchemaTraceListenerestá optimizado para el rendimiento de registro con compatibilidad implícita para el seguimiento sin bloqueos.EventSchemaTraceListener is tuned for logging performance with implicit support for lock-free tracing.

La EventSchemaTraceListener clase convierte la información de traza y de depuración en una secuencia de texto codificada en XML.The EventSchemaTraceListener class converts tracing and debugging information into an XML-encoded text stream. La descripción de la salida XML se muestra en las tablas más adelante en esta sección.The description of the XML output is shown in the tables later in this section.

Puede habilitar o deshabilitar un EventSchemaTraceListener objeto a través del archivo de configuración de la aplicación y, EventSchemaTraceListener a continuación, utilizar el objeto configurado en la aplicación.You can enable or disable an EventSchemaTraceListener object through the application configuration file, and then use the configured EventSchemaTraceListener object in your application. Como alternativa, puede crear un EventSchemaTraceListener objeto en el código.Alternately, you can create an EventSchemaTraceListener object in your code. Se recomienda habilitar los agentes de escucha de seguimiento a través del archivo de configuración de la aplicación.We recommend that you enable trace listeners through the application configuration file. Para obtener información sobre el uso de archivos de configuración para el seguimiento y la depuración, vea esquema de configuración de seguimiento ydepuración.For information about the use of configuration files for tracing and debugging, see Trace and Debug Settings Schema.

Para configurar un EventSchemaTraceListener objeto, modifique el archivo de configuración que se corresponde con el nombre de la aplicación.To configure an EventSchemaTraceListener object, modify the configuration file that corresponds to the name of your application. En este archivo, puede Agregar, quitar o establecer las propiedades de un agente de escucha.In this file, you can add, remove, or set the properties for a listener. El archivo de configuración debe tener el formato siguiente:The configuration file should be formatted as follows:

<configuration>  
    <system.diagnostics>  
        <sources>  
            <source name="TestSource" >  
                <listeners>  
                    <!--Remove the default trace listener for better performance.-->  
                    <remove name="Default"/>  
                    <!--Note: Removing the default trace listener prevents the dialog box   
                    from being displayed for Debug.Fail or Debug.Assert commands that are   
                    executed in user mode.-->  
                    <add name="eventListener"   
                      type="System.Diagnostics.EventSchemaTraceListener,  system.core"  
                      initializeData="TraceOutput.xml"   
                      traceOutputOptions="ProcessId, DateTime, Timestamp"   
                      bufferSize="65536"  
                      maximumFileSize="20480000"  
                      logRetentionOption="LimitedCircularFiles"  
                      maximumNumberOfFiles="2"/>  
                </listeners>  
            </source>  
        </sources>  
    </system.diagnostics>  

La EventSchemaTraceListener clase hereda la Filter propiedad de la clase TraceListenerbase.The EventSchemaTraceListener class inherits the Filter property from the base class TraceListener. La Filter propiedad permite un nivel adicional de filtrado de salida de seguimiento en el agente de escucha.The Filter property allows for an additional level of trace output filtering at the listener. Si hay un filtro, los Trace métodos del agente de escucha de seguimiento ShouldTrace llaman al método del filtro para determinar si se debe emitir el seguimiento.If a filter is present, the Trace methods of the trace listener call the ShouldTrace method of the filter to determine whether to emit the trace.

Si se realiza un intento de escribir en un archivo que se está usando o no está disponible, se agrega automáticamente un sufijo GUID al nombre de archivo.If an attempt is made to write to a file that is being used or is unavailable, a GUID suffix is automatically added to the file name.

Nota

Los métodos de agente de escucha están diseñados para ser llamados por Debugmétodos Tracede las TraceSource clases, y.Listener methods are intended to be called by methods of the Debug, Trace, and TraceSource classes. No llame a los métodos de escucha directamente desde el código de la aplicación.Do not call the listener methods directly from application code. El EventSchemaTraceListener agente de escucha está diseñado principalmente para su uso TraceSource por la clase.The EventSchemaTraceListener listener is primarily intended for use by the TraceSource class.

En la tabla siguiente se describen los elementos y atributos de la salida XML.The following table describes the elements and attributes of the XML output.

ElementoElement AtributosAttributes SalidaOutput NotasNotes
CallStack NingunaNone Depende de la presencia de la Callstack marca en la TraceOutputOptions propiedad.Depends on the presence of the Callstack flag in the TraceOutputOptions property. Los caracteres especiales como > o < se reemplazan por secuencias de escape.Special characters such as > or < are replaced with escape sequences. Vea la tabla de traducción de caracteres de escape en la tabla siguiente.See the escaped character translation table in the next table.
Computer NingunaNone Siempre está presente.Always present. Este elemento representa el valor de la MachineName propiedad.This element represents the value of the MachineName property.
Correlation ActivityID Siempre está presente.Always present. Si ActivityID no se especifica, el valor predeterminado es un GUID vacío.If ActivityID is not specified, the default is an empty GUID.
RelatedActivityID Depende de la presencia del relatedActivityId parámetro en la Trace llamada al método.Depends on the presence of the relatedActivityId parameter in the Trace method call. El RelatedActivityID atributo corresponde relatedActivityId al parámetro del TraceTransfer método.The RelatedActivityID attribute corresponds to the relatedActivityId parameter of the TraceTransfer method.
Data NingunaNone Siempre está presente.Always present. Este elemento representa la entrada dedataparámetros ().This element represents parameter input (data). Se proporciona un elemento para cada objeto de datos.One element is provided for each data object. En el caso de los registros de eventos Data , el elemento contiene datos XML con escape.In the case of event logs, the Data element contains escaped XML data. En el caso de los registros de datos Data , el elemento contiene datos sin escape.In the case of data logs, the Data element contains unescaped data. La salida del registro de datos ToString usa el método de los objetos de datos pasados.The data log output uses the ToString method of the passed-in data objects.
Event NingunaNone Siempre está presente.Always present. Este elemento contiene un evento de seguimiento.This element contains a trace event.
EventData NingunaNone Presente para los registros de eventos.Present for event logs. Este elemento representa la entrada demessageparámetros args(,).This element represents parameter input (message, args). Contiene Data elementos con datos XML de escape que se crean mediante una llamada TraceEvent al método.It contains Data elements with escaped XML data that is created by calling the TraceEvent method.
EventID NingunaNone Siempre está presente.Always present. Este elemento representa la entrada deidparámetros ().This element represents parameter input (id).
Execution ProcessID Depende de la presencia de la ProcessId marca en la TraceOutputOptions propiedad.Depends on the presence of the ProcessId flag in the TraceOutputOptions property. El ProcessID atributo se especifica TraceEventCacheen.The ProcessID attribute is specified in the TraceEventCache. En los sistemas operativos Microsoft Windows 98 y Windows Millennium Edition, si ProcessID es mayor que 2.147.483.647, es una representación positiva de un número negativo y debe convertirse para obtener el identificador de proceso correcto.On the Microsoft Windows 98 and Windows Millennium Edition operating systems, if ProcessID is larger than 2,147,483,647, it is a positive representation of a negative number and should be converted to obtain the correct process identifier.
ThreadID Está presente ProcessID cuando está presente.Present when ProcessID is present. El ThreadID atributo se especifica TraceEventCacheen.The ThreadID attribute is specified in the TraceEventCache.
Level NingunaNone Siempre está presente.Always present. Este elemento representa la entrada de parámetros (el valor eventTypenumérico de).This element represents parameter input (the numeric value of eventType). Los valores de parámetro mayores que 255 se muestran como un nivel 8, que representa TraceEventType.Information.Parameter values that are larger than 255 are output as a level 8, which represents TraceEventType.Information. Los tipos Criticalde evento Error Informationde seguimiento,, Verbose , y se generan como los niveles 1, 2, 4, 8 y 10, respectivamente. WarningTrace event types Critical, Error, Warning, Information, and Verbose are output as levels 1, 2, 4, 8, and 10, respectively.
LogicalOperationStack NingunaNone Depende de la presencia de la LogicalOperationStack marca en la TraceOutputOptions propiedad.Depends on the presence of the LogicalOperationStack flag in the TraceOutputOptions property. Solo puede existir una operación lógica.Only one logical operation can exist. Por lo tanto, los valores se LogicalOperation escriben como LogicalOperationStack nodos bajo el elemento.Therefore, the values are written as LogicalOperation nodes under the LogicalOperationStack element.
OpCode NingunaNone Está presente Level cuando es mayor que 255.Present when Level is greater than 255. Este elemento representa los tipos de evento de seguimiento que tienen valores numéricos mayores que 255.This element represents Trace event types that have numeric values greater than 255. Start, Stop, Suspend, Resumeo segenerancomolosniveles1,2,4,8y10,respectivamente.TransferStart, Stop, Suspend, Resume, or Transfer are output as levels 1, 2, 4, 8, and 10, respectively.
Provider GUID Siempre está presente.Always present. Siempre está vacío.Always empty.
RenderingInfo Culture Siempre está presente.Always present. Este atributo representa una cadena de recursos para el tipo de evento.This attribute represents a resource string for the event type. Siempre es "en-EN\".It is always "en-EN\".
System Name Siempre está presente.Always present.
TimeCreated SystemTime Depende de la presencia de la DateTime marca en la TraceOutputOptions propiedad.Depends on the presence of the DateTime flag in the TraceOutputOptions property. La hora es el valor de la TraceEventCache.DateTime propiedad.The time is the value of the TraceEventCache.DateTime property. Esta propiedad se expresa como hora universal coordinadaThis property is expressed as Coordinated Universal Time
TimeStamp NingunaNone Depende de la presencia de la Timestamp marca en la TraceOutputOptions propiedad.Depends on the presence of the Timestamp flag in the TraceOutputOptions property. Este elemento se especifica en TraceEventCache.This element is specified in the TraceEventCache.
UserData NingunaNone Presente para los registros de datos.Present for data logs. Este elemento contiene Data elementos con datos proporcionados por el usuario sin escape de un TraceData método.This element contains Data elements with unescaped, user-provided data from a TraceData method.

En la tabla siguiente se muestran los caracteres que se incluyen en la salida XML.The following table shows the characters that are escaped in the XML output. Los caracteres de escape se producen en todos los elementos y atributos UserData excepto en el elemento, que contiene datos sin escape proporcionados por el usuario.Escaping occurs in all the elements and attributes except for the UserData element, which contains user-provided, unescaped data. El UserData elemento es el resultado de las llamadas TraceData al método.The UserData element is a result of calls to the TraceData method.

Carácter de escapeEscaped character ValorValue
& &
< <
> >
"" "
|'
0xD0xD &#xD;&#xD;
0xA0xA &#xA;&#xA;

Constructores

EventSchemaTraceListener(String) EventSchemaTraceListener(String) EventSchemaTraceListener(String) EventSchemaTraceListener(String)

Inicializa una nueva instancia de la clase EventSchemaTraceListener y utiliza el archivo especificado como destinatario de los resultados de la traza o la depuración.Initializes a new instance of the EventSchemaTraceListener class, using the specified file as the recipient of debugging and tracing output.

EventSchemaTraceListener(String, String) EventSchemaTraceListener(String, String) EventSchemaTraceListener(String, String) EventSchemaTraceListener(String, String)

Inicializa una nueva instancia de la clase EventSchemaTraceListener con el nombre especificado y utiliza el archivo especificado como destinatario de los resultados de la traza o la depuración.Initializes a new instance of the EventSchemaTraceListener class with the specified name, using the specified file as the recipient of debugging and tracing output.

EventSchemaTraceListener(String, String, Int32) EventSchemaTraceListener(String, String, Int32) EventSchemaTraceListener(String, String, Int32) EventSchemaTraceListener(String, String, Int32)

Inicializa una nueva instancia de la clase EventSchemaTraceListener con el nombre especificado y el tamaño de búfer especificado, y utiliza el archivo especificado como destinatario de los resultados de la traza o la depuración.Initializes a new instance of the EventSchemaTraceListener class with the specified name and specified buffer size, using the specified file as the recipient of debugging and tracing output.

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption) EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption) EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption) EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption)

Inicializa una nueva instancia de la clase EventSchemaTraceListener con el nombre especificado y el tamaño de búfer especificado, y utiliza el archivo especificado, con la directiva de retención de registro especificada, como destinatario de los resultados de la traza o la depuración.Initializes a new instance of the EventSchemaTraceListener class with the specified name and specified buffer size, using the specified file with the specified log retention policy as the recipient of the debugging and tracing output.

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64) EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64) EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64) EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64)

Inicializa una nueva instancia de la clase EventSchemaTraceListener con el nombre especificado y el tamaño de búfer especificado, y utiliza el archivo especificado, con la directiva de retención de registro especificada y el tamaño máximo, como destinatario de los resultados de la traza o la depuración.Initializes a new instance of the EventSchemaTraceListener class with the specified name and specified buffer size, using the specified file with the specified log retention policy and maximum size as the recipient of the debugging and tracing output.

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64, Int32) EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64, Int32) EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64, Int32) EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64, Int32)

Inicializa una nueva instancia de la clase EventSchemaTraceListener con el nombre especificado y el tamaño de búfer especificado, y utiliza el archivo especificado, con la directiva de retención de registro especificada, el tamaño máximo y el recuento de archivos, como destinatario de los resultados de la traza o la depuración.Initializes a new instance of the EventSchemaTraceListener class with the specified name and specified buffer size, using the specified file with the specified log retention policy, maximum size, and file count as the recipient of the debugging and tracing output.

Propiedades

Attributes Attributes Attributes 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.Gets the custom trace listener attributes defined in the application configuration file.

(Inherited from TraceListener)
BufferSize BufferSize BufferSize BufferSize

Obtiene el tamaño del búfer de salida.Gets the size of the output buffer.

Filter Filter Filter Filter

Obtiene o establece el filtro de seguimiento para el agente de escucha de seguimiento.Gets or sets the trace filter for the trace listener.

(Inherited from TraceListener)
IndentLevel IndentLevel IndentLevel IndentLevel

Obtiene o establece el nivel de sangría.Gets or sets the indent level.

(Inherited from TraceListener)
IndentSize IndentSize IndentSize IndentSize

Obtiene o establece el número de espacios de una sangría.Gets or sets the number of spaces in an indent.

(Inherited from TraceListener)
IsThreadSafe IsThreadSafe IsThreadSafe IsThreadSafe

Obtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos.Gets a value indicating whether the trace listener is thread safe.

MaximumFileSize MaximumFileSize MaximumFileSize MaximumFileSize

Obtiene el tamaño máximo del archivo de registro.Gets the maximum size of the log file.

MaximumNumberOfFiles MaximumNumberOfFiles MaximumNumberOfFiles MaximumNumberOfFiles

Obtiene el número máximo de archivos de registro.Gets the maximum number of log files.

Name Name Name Name

Obtiene o establece un nombre para este objeto TraceListener.Gets or sets a name for this TraceListener.

(Inherited from TraceListener)
NeedIndent NeedIndent NeedIndent NeedIndent

Obtiene o establece un valor que indica si se va a aplicar sangría a los resultados.Gets or sets a value indicating whether to indent the output.

(Inherited from TraceListener)
TraceLogRetentionOption TraceLogRetentionOption TraceLogRetentionOption TraceLogRetentionOption

Obtiene la opción de retención de registro de la traza para el archivo.Gets the trace log retention option for the file.

TraceOutputOptions TraceOutputOptions TraceOutputOptions TraceOutputOptions

Obtiene o establece las opciones de los resultados de seguimiento.Gets or sets the trace output options.

(Inherited from TraceListener)
Writer Writer Writer Writer

Obtiene o establece el escritor de texto subyacente que escribe en el archivo de registro.Gets or sets the underlying text writer that writes to the log file.

Métodos

Close() Close() Close() Close()

Cierra el archivo de registro para este agente de escucha, de modo que ya no recibe ningún resultado de seguimiento o de depuración.Closes the log file for this listener so that it no longer receives tracing or debugging output.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos que usa TraceListener.Releases all resources used by the TraceListener.

(Inherited from TraceListener)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Desecha este objeto TextWriterTraceListener.Disposes this TextWriterTraceListener object.

(Inherited from TextWriterTraceListener)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Fail(String) Fail(String) Fail(String) Fail(String)

Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener.Emits an error message to the listener you create when you implement the TraceListener class.

(Inherited from TraceListener)
Fail(String, String) Fail(String, String) Fail(String, String) Fail(String, String)

Escribe información de error, que incluye un mensaje de error básico y un mensaje de error detallado, en el archivo de registro.Writes error information, including a basic error message and a detailed error message, to the log file.

Flush() Flush() Flush() Flush()

Hace que los datos almacenados en búfer se escriban en el registro para este agente de escucha.Causes buffered data to be written to the log for this listener.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes()

Obtiene los atributos de configuración XML personalizados que admite el agente de escucha de traza.Gets the custom XML configuration attributes that the trace listener supports.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object) TraceData(TraceEventCache, String, TraceEventType, Int32, Object) TraceData(TraceEventCache, String, TraceEventType, Int32, Object) TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Escribe la información de traza, un solo objeto de datos y la información de evento en el archivo de registro.Writes trace information, a single data object, and event information to the log file.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Escribe la información de traza, varios objetos de datos y la información de evento en el archivo de registro.Writes trace information, multiple data objects, and event information to the log file.

TraceEvent(TraceEventCache, String, TraceEventType, Int32) TraceEvent(TraceEventCache, String, TraceEventType, Int32) TraceEvent(TraceEventCache, String, TraceEventType, Int32) TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha.Writes trace and event information to the listener specific output.

(Inherited from TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Escribe la información de traza, un mensaje y la información de evento en el archivo de registro.Writes trace information, a message, and event information to the log file.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Escribe la información de la traza, un mensaje con formato y la información de evento en el archivo de registro.Writes trace information, a formatted message, and event information to the log file.

TraceTransfer(TraceEventCache, String, Int32, String, Guid) TraceTransfer(TraceEventCache, String, Int32, String, Guid) TraceTransfer(TraceEventCache, String, Int32, String, Guid) TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Escribe la información de traza (incluida la identidad de una actividad relacionada), un mensaje y la información de evento en el archivo de registro.Writes trace information, including the identity of a related activity, a message, and event information, to the log file.

Write(Object) Write(Object) Write(Object) Write(Object)

Escribe el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Inherited from TraceListener)
Write(Object, String) Write(Object, String) Write(Object, String) 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.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Inherited from TraceListener)
Write(String) Write(String) Write(String) Write(String)

Escribe un mensaje en el archivo de registro sin proporcionar ninguna información de contexto adicional.Writes a message to the log file without providing any additional context information.

Write(String, String) Write(String, String) Write(String, String) 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.Writes a category name and a message to the listener you create when you implement the TraceListener class.

(Inherited from TraceListener)
WriteIndent() WriteIndent() WriteIndent() WriteIndent()

Escribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en false.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

(Inherited from TraceListener)
WriteLine(Object) WriteLine(Object) WriteLine(Object) 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.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Inherited from TraceListener)
WriteLine(Object, String) WriteLine(Object, String) WriteLine(Object, String) 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.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Inherited from TraceListener)
WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Escribe un mensaje seguido del terminador de línea actual del archivo de registro sin proporcionar información de contexto adicional.Writes a message followed by the current line terminator to the log file without providing any additional context information.

WriteLine(String, String) WriteLine(String, String) WriteLine(String, String) 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.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Inherited from TraceListener)

Se aplica a