EventSchemaTraceListener EventSchemaTraceListener EventSchemaTraceListener EventSchemaTraceListener Class

Definizione

Dirige l'output di tracciatura o di debug degli eventi end-to-end in un file di log codificato in XML e conforme allo schema.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
Ereditarietà

Esempi

Nell'esempio di codice riportato di seguito viene illustrato EventSchemaTraceListener come utilizzare la classe.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

    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

Commenti

La EventSchemaTraceListener classe fornisce la traccia degli eventi compatibili con lo schema end-to-end.The EventSchemaTraceListener class provides tracing of end-to-end schema-compliant events. È possibile usare la traccia end-to-end per un sistema con componenti eterogenei che attraversano AppDomaini limiti dei thread, dei processi e dei computer.You can use end-to-end tracing for a system that has heterogeneous components that cross thread, AppDomain, process, and computer boundaries. Uno schema di eventi standardizzato (vedere rappresentazione dell'evento per i consumer di eventi) è stato definito per abilitare la traccia attraverso questi limiti.A standardized event schema (see Event Representation for Event Consumers) has been defined to enable tracing across these boundaries. Lo schema consente l'aggiunta di elementi personalizzati e conformi allo schema.The schema enables the addition of custom, schema-compliant elements. È possibile utilizzare lo strumento Visualizzatore di tracce dei servizi (SvcTraceViewer. exe) per visualizzare i dati dell'evento.You can use the Service Trace Viewer Tool (SvcTraceViewer.exe) to display the event data.

EventSchemaTraceListenerviene ottimizzato per la registrazione delle prestazioni con supporto implicito per la traccia senza blocco.EventSchemaTraceListener is tuned for logging performance with implicit support for lock-free tracing.

La EventSchemaTraceListener classe converte le informazioni di traccia e di debug in un flusso di testo con codifica XML.The EventSchemaTraceListener class converts tracing and debugging information into an XML-encoded text stream. La descrizione dell'output XML è illustrata nelle tabelle più avanti in questa sezione.The description of the XML output is shown in the tables later in this section.

È possibile abilitare o disabilitare un EventSchemaTraceListener oggetto tramite il file di configurazione dell'applicazione e quindi usare l' EventSchemaTraceListener oggetto configurato nell'applicazione.You can enable or disable an EventSchemaTraceListener object through the application configuration file, and then use the configured EventSchemaTraceListener object in your application. In alternativa, è possibile creare un EventSchemaTraceListener oggetto nel codice.Alternately, you can create an EventSchemaTraceListener object in your code. Si consiglia di abilitare i listener di traccia tramite il file di configurazione dell'applicazione.We recommend that you enable trace listeners through the application configuration file. Per informazioni sull'utilizzo dei file di configurazione per la traccia e il debug, vedere schema delle impostazioni di traccia e debug.For information about the use of configuration files for tracing and debugging, see Trace and Debug Settings Schema.

Per configurare un EventSchemaTraceListener oggetto, modificare il file di configurazione che corrisponde al nome dell'applicazione.To configure an EventSchemaTraceListener object, modify the configuration file that corresponds to the name of your application. In questo file è possibile aggiungere, rimuovere o impostare le proprietà di un listener.In this file, you can add, remove, or set the properties for a listener. Il file di configurazione deve essere formattato come segue: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 classe eredita la Filter proprietà dalla classe TraceListenerdi base.The EventSchemaTraceListener class inherits the Filter property from the base class TraceListener. La Filter proprietà consente un ulteriore livello di filtraggio dell'output di traccia nel listener.The Filter property allows for an additional level of trace output filtering at the listener. Se è presente un filtro, i Trace metodi del listener di traccia chiamano il ShouldTrace metodo del filtro per determinare se generare la traccia.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.

Se viene effettuato un tentativo di scrittura in un file in uso o non disponibile, viene automaticamente aggiunto un suffisso GUID al nome del file.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

I Debugmetodi del listener devono essere chiamati dai metodi delle classi, Tracee TraceSource .Listener methods are intended to be called by methods of the Debug, Trace, and TraceSource classes. Non chiamare direttamente i metodi del listener dal codice dell'applicazione.Do not call the listener methods directly from application code. Il EventSchemaTraceListener listener è destinato principalmente all'uso da parte TraceSource della classe.The EventSchemaTraceListener listener is primarily intended for use by the TraceSource class.

Nella tabella seguente vengono descritti gli elementi e gli attributi dell'output XML.The following table describes the elements and attributes of the XML output.

ElementoElement AttributiAttributes OutputOutput NoteNotes
CallStack nessunoNone Dipende dalla presenza del Callstack flag TraceOutputOptions nella proprietà.Depends on the presence of the Callstack flag in the TraceOutputOptions property. I caratteri speciali, ad esempio > o <, vengono sostituiti da sequenze di escape.Special characters such as > or < are replaced with escape sequences. Vedere la tabella di conversione dei caratteri di escape nella tabella seguente.See the escaped character translation table in the next table.
Computer nessunoNone Sempre presente.Always present. Questo elemento rappresenta il valore della MachineName proprietà.This element represents the value of the MachineName property.
Correlation ActivityID Sempre presente.Always present. Se ActivityID viene omesso, il valore predefinito è un GUID vuoto.If ActivityID is not specified, the default is an empty GUID.
RelatedActivityID Dipende dalla presenza del relatedActivityId parametro Trace nella chiamata al metodo.Depends on the presence of the relatedActivityId parameter in the Trace method call. L' RelatedActivityID attributo corrisponde relatedActivityId al parametro del TraceTransfer metodo.The RelatedActivityID attribute corresponds to the relatedActivityId parameter of the TraceTransfer method.
Data nessunoNone Sempre presente.Always present. Questo elemento rappresenta l'input deldataparametro ().This element represents parameter input (data). Viene fornito un elemento per ogni oggetto dati.One element is provided for each data object. Nel caso dei registri eventi, l' Data elemento contiene dati XML di escape.In the case of event logs, the Data element contains escaped XML data. Nel caso dei log di dati, l' Data elemento contiene dati non di escape.In the case of data logs, the Data element contains unescaped data. L'output del log dei dati ToString usa il metodo degli oggetti dati passati.The data log output uses the ToString method of the passed-in data objects.
Event nessunoNone Sempre presente.Always present. Questo elemento contiene un evento di traccia.This element contains a trace event.
EventData nessunoNone Presente per i log eventi.Present for event logs. Questo elemento rappresenta l'input delmessageparametro args(,).This element represents parameter input (message, args). Contiene Data elementi con dati XML di escape creati chiamando il TraceEvent metodo.It contains Data elements with escaped XML data that is created by calling the TraceEvent method.
EventID nessunoNone Sempre presente.Always present. Questo elemento rappresenta l'input delidparametro ().This element represents parameter input (id).
Execution ProcessID Dipende dalla presenza del ProcessId flag TraceOutputOptions nella proprietà.Depends on the presence of the ProcessId flag in the TraceOutputOptions property. L' ProcessID attributo viene specificato TraceEventCachein.The ProcessID attribute is specified in the TraceEventCache. Nei sistemi operativi Microsoft Windows 98 e Windows Millennium Edition, se ProcessID è maggiore di 2.147.483.647, è una rappresentazione positiva di un numero negativo e deve essere convertito per ottenere l'identificatore di processo corretto.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 Presente quando ProcessID è presente.Present when ProcessID is present. L' ThreadID attributo viene specificato TraceEventCachein.The ThreadID attribute is specified in the TraceEventCache.
Level nessunoNone Sempre presente.Always present. Questo elemento rappresenta l'input del parametro (il valore eventTypenumerico di).This element represents parameter input (the numeric value of eventType). I valori di parametro maggiori di 255 vengono restituiti come livello 8, che rappresenta TraceEventType.Information.Parameter values that are larger than 255 are output as a level 8, which represents TraceEventType.Information. I Criticaltipi di evento di Warningtraccia Information, Error, Verbose , e sono restituiti rispettivamente come livelli 1, 2, 4, 8 e 10.Trace event types Critical, Error, Warning, Information, and Verbose are output as levels 1, 2, 4, 8, and 10, respectively.
LogicalOperationStack nessunoNone Dipende dalla presenza del LogicalOperationStack flag TraceOutputOptions nella proprietà.Depends on the presence of the LogicalOperationStack flag in the TraceOutputOptions property. Può esistere una sola operazione logica.Only one logical operation can exist. I valori vengono pertanto scritti come LogicalOperation nodi LogicalOperationStack nell'elemento.Therefore, the values are written as LogicalOperation nodes under the LogicalOperationStack element.
OpCode nessunoNone Presente quando Level è maggiore di 255.Present when Level is greater than 255. Questo elemento rappresenta i tipi di eventi di traccia con valori numerici maggiori di 255.This element represents Trace event types that have numeric values greater than 255. Start, Stop, ,Resumeo sonoTransfer rispettivamente output come livelli 1, 2, 4, 8 e 10. SuspendStart, Stop, Suspend, Resume, or Transfer are output as levels 1, 2, 4, 8, and 10, respectively.
Provider GUID Sempre presente.Always present. Sempre vuoto.Always empty.
RenderingInfo Culture Sempre presente.Always present. Questo attributo rappresenta una stringa di risorsa per il tipo di evento.This attribute represents a resource string for the event type. È sempre "en-EN\".It is always "en-EN\".
System Name Sempre presente.Always present.
TimeCreated SystemTime Dipende dalla presenza del DateTime flag TraceOutputOptions nella proprietà.Depends on the presence of the DateTime flag in the TraceOutputOptions property. L'ora è il valore della TraceEventCache.DateTime proprietà.The time is the value of the TraceEventCache.DateTime property. Questa proprietà è espressa come ora UTC (Coordinated Universal Time)This property is expressed as Coordinated Universal Time
TimeStamp nessunoNone Dipende dalla presenza del Timestamp flag TraceOutputOptions nella proprietà.Depends on the presence of the Timestamp flag in the TraceOutputOptions property. Questo elemento viene specificato in TraceEventCache.This element is specified in the TraceEventCache.
UserData nessunoNone Presente per i log di dati.Present for data logs. Questo elemento contiene Data elementi con dati non di escape e forniti dall'utente da un TraceData metodo.This element contains Data elements with unescaped, user-provided data from a TraceData method.

Nella tabella seguente vengono illustrati i caratteri di escape nell'output XML.The following table shows the characters that are escaped in the XML output. L'escape si verifica in tutti gli elementi e gli attributi ad UserData eccezione dell'elemento, che contiene dati non di escape specificati dall'utente.Escaping occurs in all the elements and attributes except for the UserData element, which contains user-provided, unescaped data. L' UserData elemento è un risultato di chiamate TraceData al metodo.The UserData element is a result of calls to the TraceData method.

Caratteri di escapeEscaped character ValueValue
& &
< <
> >
"" "
|'
0xD0xD &#xD;&#xD;
0xA0xA &#xA;&#xA;

Costruttori

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

Inizializza una nuova istanza della classe EventSchemaTraceListener, utilizzando il file specificato come destinatario dell'output di debug e di tracciatura.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)

Inizializza una nuova istanza della classe EventSchemaTraceListener con il nome specificato, utilizzando il file specificato come destinatario dell'output di debug e di tracciatura.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)

Inizializza una nuova istanza della classe EventSchemaTraceListener con il nome e la dimensione del buffer specificati, utilizzando il file specificato come destinatario dell'output di debug e di tracciatura.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)

Inizializza una nuova istanza della classe EventSchemaTraceListener con il nome e la dimensione del buffer specificati, utilizzando il file specificato con i criteri di conservazione dei log indicati come destinatario dell'output di debug e di tracciatura.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)

Inizializza una nuova istanza della classe EventSchemaTraceListener con il nome e la dimensione del buffer specificati, utilizzando il file specificato con i criteri di conservazione dei log e la dimensione massima indicati come destinatario dell'output di debug e di tracciatura.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)

Inizializza una nuova istanza della classe EventSchemaTraceListener con il nome e la dimensione del buffer specificati, utilizzando il file specificato con i criteri di conservazione dei log, la dimensione massima e il conteggio di file indicati come destinatario dell'output di debug e di tracciatura.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.

Proprietà

Attributes Attributes Attributes Attributes

Ottiene gli attributi personalizzati del listener di traccia definiti nel file di configurazione dell'applicazione.Gets the custom trace listener attributes defined in the application configuration file.

(Inherited from TraceListener)
BufferSize BufferSize BufferSize BufferSize

Ottiene le dimensioni del buffer di output.Gets the size of the output buffer.

Filter Filter Filter Filter

Ottiene o imposta il filtro di traccia per il listener di traccia.Gets or sets the trace filter for the trace listener.

(Inherited from TraceListener)
IndentLevel IndentLevel IndentLevel IndentLevel

Ottiene o imposta il livello di rientro.Gets or sets the indent level.

(Inherited from TraceListener)
IndentSize IndentSize IndentSize IndentSize

Ottiene o imposta il numero di spazi in un rientro.Gets or sets the number of spaces in an indent.

(Inherited from TraceListener)
IsThreadSafe IsThreadSafe IsThreadSafe IsThreadSafe

Ottiene un valore che indica se il listener di traccia è thread-safe.Gets a value indicating whether the trace listener is thread safe.

MaximumFileSize MaximumFileSize MaximumFileSize MaximumFileSize

Ottiene la dimensione massima del file di log.Gets the maximum size of the log file.

MaximumNumberOfFiles MaximumNumberOfFiles MaximumNumberOfFiles MaximumNumberOfFiles

Ottiene il numero massimo di file di log.Gets the maximum number of log files.

Name Name Name Name

Ottiene o imposta un nome per questa classe TraceListener.Gets or sets a name for this TraceListener.

(Inherited from TraceListener)
NeedIndent NeedIndent NeedIndent NeedIndent

Ottiene o imposta un valore che indica se impostare il rientro dell'output.Gets or sets a value indicating whether to indent the output.

(Inherited from TraceListener)
TraceLogRetentionOption TraceLogRetentionOption TraceLogRetentionOption TraceLogRetentionOption

Ottiene l'opzione di conservazione dei registri di traccia per il file.Gets the trace log retention option for the file.

TraceOutputOptions TraceOutputOptions TraceOutputOptions TraceOutputOptions

Ottiene o imposta le opzioni dell'output di traccia.Gets or sets the trace output options.

(Inherited from TraceListener)
Writer Writer Writer Writer

Ottiene o imposta il writer di testo sottostante che scrive nel file di log.Gets or sets the underlying text writer that writes to the log file.

Metodi

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

Chiude il file di log per questo listener in modo che non riceva più output di tracciatura o di debug.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)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto 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()

Rilascia tutte le risorse usate da TraceListener.Releases all resources used by the TraceListener.

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

Elimina questo oggetto TextWriterTraceListener.Disposes this TextWriterTraceListener object.

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

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

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

Genera un messaggio di errore nel listener creato durante l'implementazione della classe 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)

Scrive informazioni sull'errore, incluso un messaggio di errore di base e un messaggio di errore dettagliato, nel file di log.Writes error information, including a basic error message and a detailed error message, to the log file.

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

Fa sì che i dati memorizzati nel buffer siano scritti nel registro per questo listener.Causes buffered data to be written to the log for this listener.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Ottiene gli attributi di configurazione XML personalizzati supportati dal listener di traccia.Gets the custom XML configuration attributes that the trace listener supports.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

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

Restituisce una stringa che rappresenta l'oggetto corrente.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)

Scrive le informazioni di traccia, un singolo oggetto dati e le informazioni sull'evento nel file di log.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[])

Scrive le informazioni di traccia, più oggetti dati e le informazioni sull'evento nel file di log.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)

Scrive le informazioni di traccia e di evento nell'output specifico del listener.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)

Scrive le informazioni di traccia, un messaggio e le informazioni sull'evento nel file di log.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[])

Scrive le informazioni di traccia, un messaggio formattato e le informazioni sull'evento nel file di log.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)

Scrive le informazioni di traccia, tra cui l'identità di un'attività correlata, un messaggio e le informazioni sull'evento, nel file di log.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)

Scrive il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe 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)

Scrive un nome di categoria e il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe 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)

Scrive un messaggio nel file di log senza fornire informazioni di contesto aggiuntive.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)

Scrive un nome di categoria e un messaggio nel listener creato durante l'implementazione della classe 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()

Inserisce il rientro nel listener creato quando si implementa questa classe e reimposta la proprietà NeedIndent su 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)

Scrive il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener, seguito da un terminatore di riga.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)

Scrive un nome di categoria e il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener, seguito da un terminatore di riga.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)

Scrive un messaggio, seguito dal terminatore di riga corrente, nel file di log senza fornire informazioni di contesto aggiuntive.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)

Scrive un nome di categoria e un messaggio nel listener creato durante l'implementazione della classe TraceListener, seguiti da un terminatore di riga.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)

Si applica a