TextWriterTraceListener Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Indirizza l'output di traccia o debug a un oggetto TextWriter o a un Streamoggetto , ad esempio FileStream.
public ref class TextWriterTraceListener : System::Diagnostics::TraceListenerpublic class TextWriterTraceListener : System.Diagnostics.TraceListenertype TextWriterTraceListener = class
inherit TraceListenerPublic Class TextWriterTraceListener
Inherits TraceListener- Ereditarietà
- Ereditarietà
- Derivato
Esempio
Nell'esempio seguente viene implementata un'istanza della TextWriterTraceListener classe che usa una StreamWriter chiamata myOutputWriter per scrivere in un file denominato TestFile.txt. Prima di tutto l'esempio crea un file per l'output. Crea quindi l'oggetto StreamWriter per il primo writer di testo, lo assegna al file di output e lo aggiunge a Listeners. Il codice restituisce quindi una riga di testo nel file. Infine, l'esempio scarica il buffer di output.
Dopo aver eseguito questo esempio, è possibile aprire il TestFile.txt file per visualizzare l'output.
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 traccia o debug.
Importante
Questo tipo implementa l'interfaccia IDisposable . Al termine dell'uso del tipo, è necessario eliminarlo direttamente o indirettamente. Per eliminare direttamente il tipo, chiamare il Dispose relativo metodo in un try/catch blocco. Per eliminarlo indirettamente, usare un costrutto del linguaggio, ad using esempio (in C#) o Using (in Visual Basic). Per altre informazioni, vedere la sezione "Uso di un oggetto che implementa IDisposable" nell'argomento relativo all'interfaccia IDisposable .
Questa classe fornisce anche metodi all'oggetto CloseWriter in modo che non riceva più l'output di traccia o debug, nel Flush buffer di output per e Writera Write un messaggio all'oggetto Writer.
È necessario abilitare la traccia o il debug per usare un listener di traccia. La sintassi seguente è specifica del compilatore. Se si usano compilatori diversi da C# o Visual Basic, vedere la documentazione per il compilatore.
Per abilitare il debug in C#, aggiungere il
/d:DEBUGflag alla riga di comando del compilatore durante la compilazione del codice oppure aggiungere#define DEBUGall'inizio del file. In Visual Basic aggiungere il/d:DEBUG=Trueflag alla riga di comando del compilatore.Per abilitare la traccia in C#, aggiungere il
/d:TRACEflag alla riga di comando del compilatore quando si compila il codice o aggiungerlo#define TRACEall'inizio del file. In Visual Basic aggiungere il/d:TRACE=Trueflag alla riga di comando del compilatore.
Per aggiungere un listener di traccia in un'app .NET Framework, modificare il file di configurazione corrispondente al nome dell'applicazione. All'interno di questo file è possibile aggiungere un listener, impostarne il tipo e impostarne il parametro, rimuovere un listener o cancellare tutti i listener impostati in precedenza dall'applicazione. Il file di configurazione deve essere formattato come nell'esempio seguente.
<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>
Annotazioni
Se si tenta di scrivere in un file in uso o non disponibile, il nome del file viene preceduto automaticamente da un GUID.
Costruttori
| Nome | Descrizione |
|---|---|
| TextWriterTraceListener() |
Inizializza una nuova istanza della TextWriterTraceListener classe con TextWriter come destinatario di output. |
| TextWriterTraceListener(Stream, String) |
Inizializza una nuova istanza della TextWriterTraceListener classe con il nome specificato, utilizzando il flusso come destinatario dell'output di debug e traccia. |
| TextWriterTraceListener(Stream) |
Inizializza una nuova istanza della TextWriterTraceListener classe utilizzando il flusso come destinatario dell'output di debug e traccia. |
| TextWriterTraceListener(String, String) |
Inizializza una nuova istanza della TextWriterTraceListener classe con il nome specificato, utilizzando il file come destinatario dell'output di debug e traccia. |
| TextWriterTraceListener(String) |
Inizializza una nuova istanza della TextWriterTraceListener classe utilizzando il file come destinatario dell'output di debug e traccia. |
| TextWriterTraceListener(TextWriter, String) |
Inizializza una nuova istanza della TextWriterTraceListener classe con il nome specificato, utilizzando il writer specificato come destinatario dell'output di traccia o debug. |
| TextWriterTraceListener(TextWriter) |
Inizializza una nuova istanza della TextWriterTraceListener classe utilizzando il writer specificato come destinatario dell'output di traccia o debug. |
Proprietà
| Nome | Descrizione |
|---|---|
| Attributes |
Ottiene gli attributi del listener di traccia personalizzati definiti nel file di configurazione dell'applicazione. (Ereditato da TraceListener) |
| Filter |
Ottiene o imposta il filtro di traccia per il listener di traccia. (Ereditato da TraceListener) |
| IndentLevel |
Ottiene o imposta il livello di rientro. (Ereditato da TraceListener) |
| IndentSize |
Ottiene o imposta il numero di spazi in un rientro. (Ereditato da TraceListener) |
| IsThreadSafe |
Ottiene un valore che indica se il listener di traccia è thread-safe. (Ereditato da TraceListener) |
| Name |
Ottiene o imposta un nome per l'oggetto TraceListener. (Ereditato da TraceListener) |
| NeedIndent |
Ottiene o imposta un valore che indica se impostare il rientro dell'output. (Ereditato da TraceListener) |
| TraceOutputOptions |
Ottiene o imposta le opzioni di output della traccia. (Ereditato da TraceListener) |
| Writer |
Ottiene o imposta il writer di testo che riceve l'output di traccia o debug. |
Metodi
| Nome | Descrizione |
|---|---|
| Close() |
Chiude in modo che non riceva più l'output Writer di traccia o debug. |
| CreateObjRef(Type) |
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject) |
| Dispose() |
Rilascia tutte le risorse usate da TraceListener. (Ereditato da TraceListener) |
| Dispose(Boolean) |
Elimina questo TextWriterTraceListener oggetto. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| Fail(String, String) |
Genera un messaggio di errore e un messaggio di errore dettagliato al listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Fail(String) |
Genera un messaggio di errore al listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Flush() |
Scarica il buffer di output per .Writer |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Obsoleti.
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| GetSupportedAttributes() |
Ottiene gli attributi personalizzati supportati dal listener di traccia. (Ereditato da TraceListener) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| InitializeLifetimeService() |
Obsoleti.
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Scrive informazioni di traccia, un oggetto dati e informazioni sugli eventi nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Scrive informazioni di traccia, una matrice di oggetti dati e informazioni sugli eventi nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Scrive informazioni di traccia, una matrice formattata di oggetti e informazioni sugli eventi nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Scrive informazioni di traccia, un messaggio e informazioni sull'evento nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Scrive le informazioni di traccia e evento nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Scrive informazioni di traccia, un messaggio, un'identità di attività correlata e informazioni sugli eventi nell'output specifico del listener. (Ereditato da TraceListener) |
| Write(Object, String) |
Scrive un nome di categoria e il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Write(Object) |
Scrive il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Write(String, String) |
Scrive un nome di categoria e un messaggio nel listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Write(String) |
Scrive un messaggio nell'istanza di Writer. |
| WriteIndent() |
Scrive il rientro nel listener creato quando si implementa questa classe e la proprietà viene reimpostata NeedIndent su |
| WriteLine(Object, String) |
Scrive un nome di categoria e il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe, seguita da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(Object) |
Scrive il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe, seguita da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(String, String) |
Scrive un nome di categoria e un messaggio nel listener creato quando si implementa la TraceListener classe , seguito da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(String) |
Scrive un messaggio in Writer questa istanza seguito da un terminatore di riga. Il carattere di terminazione della riga predefinito è un ritorno a capo seguito da un avanzamento riga (\r\n). |
