TextWriterTraceListener Classe

Definizione

Invia l'output di tracciatura o di debug a un oggetto TextWriter o a un oggetto Stream, ad esempio FileStream.Directs tracing or debugging output to a TextWriter or to a Stream, such as FileStream.

public ref class TextWriterTraceListener : System::Diagnostics::TraceListener
public class TextWriterTraceListener : System.Diagnostics.TraceListener
type TextWriterTraceListener = class
    inherit TraceListener
Public Class TextWriterTraceListener
Inherits TraceListener
Ereditarietà
TextWriterTraceListener
Derivato

Esempi

Nell'esempio seguente viene implementata un'istanza TextWriterTraceListener della classe che utilizza StreamWriter un myOutputWriter oggetto chiamato per scrivere in un TestFile.txtfile denominato.The following example implements an instance of the TextWriterTraceListener class that uses a StreamWriter called myOutputWriter to write to a file named TestFile.txt. Per prima cosa viene creato un file per l'output.First the example creates a file for output. Crea quindi l'oggetto StreamWriter per il primo writer Listenersdi testo, lo assegna al file di output e lo aggiunge a.Then it creates the StreamWriter for the first text writer, assigns it the output file, and adds it to the Listeners. Il codice restituisce quindi una riga di testo al file.Then, the code outputs one line of text to the file. Infine, l'esempio Scarica il buffer di output.Finally, the example flushes the output buffer.

Dopo aver eseguito questo esempio, è possibile aprire TestFile.txt il file per visualizzare l'output.After running this sample, you can open the TestFile.txt file to see the output.

void main()
{
   #if defined(TRACE)
   // Create a file for output named TestFile.txt.
   Stream^ myFile = File::Create( "TestFile.txt" );
   
   // Create a new text writer using the output stream and
   // add it to the trace listeners.
   TextWriterTraceListener^ myTextListener = 
      gcnew TextWriterTraceListener( myFile );
   Trace::Listeners->Add( myTextListener );
  
   // Write output to the file.
   Trace::Write( "Test output " );
  
   // Flush the output.
   Trace::Flush();
   Trace::Close();
   #endif
}
public class Sample
{

public static int Main(string[] args) {
    // Create a file for output named TestFile.txt.
    Stream myFile = File.Create("TestFile.txt");
 
    /* Create a new text writer using the output stream, and add it to
     * the trace listeners. */
    TextWriterTraceListener myTextListener = new 
       TextWriterTraceListener(myFile);
    Trace.Listeners.Add(myTextListener);
 
    // Write output to the file.
    Trace.Write("Test output ");
 

    // Flush the output.
    Trace.Flush(); 

    return 0;
 }

}
Public Class Sample
    
    Public Shared Sub Main()
        ' Create a file for output named TestFile.txt.
        Dim myFile As Stream = File.Create("TestFile.txt")
        
        ' Create a new text writer using the output stream, and add it to
        ' the trace listeners. 
        Dim myTextListener As New TextWriterTraceListener(myFile)
        Trace.Listeners.Add(myTextListener)

        
        ' Write output to the file.
        Trace.Write("Test output ")
        
        ' Flush the output.
        Trace.Flush() 

        System.Environment.ExitCode = 0
    End Sub

End Class

Commenti

La TextWriterTraceListener classe fornisce la Writer proprietà per ottenere o impostare il writer di testo che riceve l'output di tracciatura o di debug.The TextWriterTraceListener class provides the Writer property to get or set the text writer that receives the tracing or debugging output.

Importante

Il tipo implementa l'interfaccia IDisposable.This type implements the IDisposable interface. Dopo aver utilizzato il tipo, è necessario eliminarlo direttamente o indirettamente.When you have finished using the type, you should dispose of it either directly or indirectly. Per eliminare direttamente il tipo, chiamare il metodo Dispose in un blocco try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Per eliminarlo indirettamente, utilizzare un costrutto di linguaggio come ad esempio using in C# o Using in Visual Basic.To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Per altre informazioni, vedere la sezione "Uso di un oggetto che implementa IDisposable" nell'argomento relativo all'interfaccia IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Questa classe fornisce anche metodi a Close in Writer modo che non riceva più output di tracciatura Flush o di debug, nel buffer di output Writerper e in Write un messaggio a Writer.This class also provides methods to Close the Writer so that it no longer receives tracing or debugging output, to Flush the output buffer for the Writer, and to Write a message to the Writer.

È necessario abilitare la traccia o il debug per utilizzare un listener di traccia.You must enable tracing or debugging to use a trace listener. La sintassi seguente è specifica del compilatore.The following syntax is compiler specific. Se si usano compilatori diversi C# da o Visual Basic, fare riferimento alla documentazione del compilatore.If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • Per abilitare il debug C#in, aggiungere /d:DEBUG il flag alla riga di comando del compilatore quando si compila il codice oppure è possibile #define DEBUG aggiungerlo all'inizio del file.To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or you can add #define DEBUG to the top of your file. In Visual Basic aggiungere il /d:DEBUG=True flag alla riga di comando del compilatore.In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.

  • Per abilitare l'analisi C#in, aggiungere /d:TRACE il flag alla riga di comando del compilatore quando si compila il codice oppure #define TRACE aggiungerlo all'inizio del file.To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. In Visual Basic aggiungere il /d:TRACE=True flag alla riga di comando del compilatore.In Visual Basic, add the /d:TRACE=True flag to the compiler command line.

Per aggiungere un listener di traccia, modificare il file di configurazione che corrisponde al nome dell'applicazione.To add a trace listener, edit the configuration file that corresponds to the name of your application. All'interno di questo file è possibile aggiungere un listener, impostarne il tipo e impostarne il parametro, rimuovere un listener o deselezionare tutti i listener precedentemente impostati dall'applicazione.Within this file, you can add a listener, set its type and set its parameter, remove a listener, or clear all the listeners previously set by the application. Il file di configurazione deve essere formattato come l'esempio seguente.The configuration file should be formatted like the following example.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener"   
          type="System.Diagnostics.TextWriterTraceListener"   
          initializeData="TextWriterOutput.log" />  
        <remove name="Default" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Nota

Se viene effettuato un tentativo di scrittura in un file in uso o non disponibile, il nome del file viene preceduto automaticamente da un GUID.If an attempt is made to write to a file that is in use or unavailable, the file name is automatically prefixed by a GUID.

Costruttori

TextWriterTraceListener()

Inizializza una nuova istanza della classe TextWriterTraceListener con TextWriter come destinatario dell'output.Initializes a new instance of the TextWriterTraceListener class with TextWriter as the output recipient.

TextWriterTraceListener(Stream)

Inizializza una nuova istanza della classe TextWriterTraceListener, utilizzando il flusso come destinatario dell'output di debug o di tracciatura.Initializes a new instance of the TextWriterTraceListener class, using the stream as the recipient of the debugging and tracing output.

TextWriterTraceListener(Stream, String)

Inizializza una nuova istanza della classe TextWriterTraceListener con il nome specificato, utilizzando il flusso come destinatario dell'output di debug o di tracciatura.Initializes a new instance of the TextWriterTraceListener class with the specified name, using the stream as the recipient of the debugging and tracing output.

TextWriterTraceListener(String)

Inizializza una nuova istanza della classe TextWriterTraceListener, utilizzando il file come destinatario dell'output di debug o di tracciatura.Initializes a new instance of the TextWriterTraceListener class, using the file as the recipient of the debugging and tracing output.

TextWriterTraceListener(String, String)

Inizializza una nuova istanza della classe TextWriterTraceListener con il nome specificato, utilizzando il file come destinatario dell'output di debug o di tracciatura.Initializes a new instance of the TextWriterTraceListener class with the specified name, using the file as the recipient of the debugging and tracing output.

TextWriterTraceListener(TextWriter)

Inizializza una nuova istanza della classe TextWriterTraceListener utilizzando il writer specificato come destinatario dell'output di tracciatura o di debug.Initializes a new instance of the TextWriterTraceListener class using the specified writer as recipient of the tracing or debugging output.

TextWriterTraceListener(TextWriter, String)

Inizializza una nuova istanza della classe TextWriterTraceListener con il nome specificato, utilizzando il writer specificato come destinatario dell'output di tracciatura o di debug.Initializes a new instance of the TextWriterTraceListener class with the specified name, using the specified writer as recipient of the tracing or debugging output.

Proprietà

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.

(Ereditato da TraceListener)
Filter

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

(Ereditato da TraceListener)
IndentLevel

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

(Ereditato da TraceListener)
IndentSize

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

(Ereditato da TraceListener)
IsThreadSafe

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

(Ereditato da TraceListener)
Name

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

(Ereditato da TraceListener)
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.

(Ereditato da TraceListener)
TraceOutputOptions

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

(Ereditato da TraceListener)
Writer

Ottiene o imposta il writer di testo che riceve l'output di tracciatura o di debug.Gets or sets the text writer that receives the tracing or debugging output.

Metodi

Close()

Chiude la classe Writer in modo che non riceva più output di tracciatura o di debug.Closes the Writer so that it no longer receives tracing or debugging output.

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.

(Ereditato da MarshalByRefObject)
Dispose()

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

(Ereditato da TraceListener)
Dispose(Boolean)

Elimina questo oggetto TextWriterTraceListener.Disposes this TextWriterTraceListener object.

Equals(Object)

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

(Ereditato da Object)
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.

(Ereditato da TraceListener)
Fail(String, String)

Genera un messaggio di errore e un messaggio di errore dettagliato nel listener creato durante l'implementazione della classe TraceListener.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

(Ereditato da TraceListener)
Flush()

Scarica il buffer di output per la classe Writer.Flushes the output buffer for the Writer.

GetHashCode()

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

(Ereditato da Object)
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.

(Ereditato da MarshalByRefObject)
GetSupportedAttributes()

Ottiene gli attributi personalizzati supportati dal listener di traccia.Gets the custom attributes supported by the trace listener.

(Ereditato da TraceListener)
GetType()

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

(Ereditato da Object)
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.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

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

(Ereditato da Object)
MemberwiseClone(Boolean)

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

(Ereditato da MarshalByRefObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Scrive le informazioni di traccia, un oggetto dati e le informazioni di evento nell'output specifico del listener.Writes trace information, a data object and event information to the listener specific output.

(Ereditato da TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Scrive le informazioni di traccia, una matrice di oggetti dati e le informazioni di evento nell'output specifico del listener.Writes trace information, an array of data objects and event information to the listener specific output.

(Ereditato da TraceListener)
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.

(Ereditato da TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Scrive le informazioni di traccia, un messaggio e le informazioni di evento nell'output specifico del listener.Writes trace information, a message, and event information to the listener specific output.

(Ereditato da TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Scrive le informazioni di traccia, una matrice di oggetti formattata e le informazioni di evento nell'output specifico del listener.Writes trace information, a formatted array of objects and event information to the listener specific output.

(Ereditato da TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Scrive le informazioni di traccia, un messaggio, l'identità di un'attività correlata e le informazioni di evento nell'output specifico del listener.Writes trace information, a message, a related activity identity and event information to the listener specific output.

(Ereditato da TraceListener)
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.

(Ereditato da TraceListener)
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.

(Ereditato da TraceListener)
Write(String)

Scrive un messaggio nella classe Writer di questa istanza.Writes a message to this instance's Writer.

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.

(Ereditato da TraceListener)
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.

(Ereditato da TraceListener)
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.

(Ereditato da TraceListener)
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.

(Ereditato da TraceListener)
WriteLine(String)

Scrive un messaggio nella classe Writer di questa istanza, seguito da un terminatore di riga.Writes a message to this instance's Writer followed by a line terminator. Il terminatore di riga predefinito è un ritorno a capo seguito da un avanzamento riga (\r\n).The default line terminator is a carriage return followed by a line feed (\r\n).

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.

(Ereditato da TraceListener)

Si applica a

Vedi anche