TextWriterTraceListener Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Dirige le suivi ou le débogage de sortie vers un TextWriter ou vers un Stream, par FileStreamexemple .
public ref class TextWriterTraceListener : System::Diagnostics::TraceListenerpublic class TextWriterTraceListener : System.Diagnostics.TraceListenertype TextWriterTraceListener = class
inherit TraceListenerPublic Class TextWriterTraceListener
Inherits TraceListener- Héritage
- Héritage
- Dérivé
Exemples
L’exemple suivant implémente une instance de la TextWriterTraceListener classe qui utilise un StreamWriter appelé myOutputWriter pour écrire dans un fichier nommé TestFile.txt. Tout d’abord, l’exemple crée un fichier pour la sortie. Ensuite, il crée le StreamWriter premier enregistreur de texte, l’affecte au fichier de sortie et l’ajoute au Listenersfichier . Ensuite, le code génère une ligne de texte dans le fichier. Enfin, l’exemple vide la mémoire tampon de sortie.
Après avoir exécuté cet exemple, vous pouvez ouvrir le TestFile.txt fichier pour afficher la sortie.
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
Remarques
La TextWriterTraceListener classe fournit la Writer propriété pour obtenir ou définir l’enregistreur de texte qui reçoit la sortie de suivi ou de débogage.
Important
Ce type implémente l’interface IDisposable . Une fois que vous avez fini d’utiliser le type, vous devez le supprimer directement ou indirectement. Pour supprimer directement le type, appelez sa Dispose méthode dans un try/catch bloc. Pour la supprimer indirectement, utilisez une construction de langage telle que using (en C#) ou Using (en Visual Basic). Pour plus d’informations, consultez la section « Utilisation d’un objet implémentant IDisposable » dans la rubrique d’interface IDisposable .
Cette classe fournit également des méthodes pour CloseWriter qu’elle ne reçoive plus de suivi ou de débogage de sortie, vers Flush la mémoire tampon de sortie pour le Writer, et vers Write un message à l’objet Writer.
Vous devez activer le suivi ou le débogage pour utiliser un écouteur de suivi. La syntaxe suivante est spécifique au compilateur. Si vous utilisez des compilateurs autres que C# ou Visual Basic, reportez-vous à la documentation de votre compilateur.
Pour activer le débogage en C#, ajoutez l’indicateur
/d:DEBUGà la ligne de commande du compilateur lorsque vous compilez votre code, ou vous pouvez ajouter#define DEBUGen haut de votre fichier. Dans Visual Basic, ajoutez l’indicateur/d:DEBUG=Trueà la ligne de commande du compilateur.Pour activer le suivi en C#, ajoutez l’indicateur
/d:TRACEà la ligne de commande du compilateur lorsque vous compilez votre code ou ajoutez-y#define TRACEen haut de votre fichier. Dans Visual Basic, ajoutez l’indicateur/d:TRACE=Trueà la ligne de commande du compilateur.
Pour ajouter un écouteur de trace dans une application .NET Framework, modifiez le fichier de configuration qui correspond au nom de votre application. Dans ce fichier, vous pouvez ajouter un écouteur, définir son type et définir son paramètre, supprimer un écouteur ou effacer tous les écouteurs précédemment définis par l’application. Le fichier de configuration doit être mis en forme comme l’exemple suivant.
<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>
Note
Si une tentative d’écriture dans un fichier en cours d’utilisation ou non disponible est effectuée, le nom du fichier est automatiquement précédé d’un GUID.
Constructeurs
| Nom | Description |
|---|---|
| TextWriterTraceListener() |
Initialise une nouvelle instance de la TextWriterTraceListener classe avec TextWriter comme destinataire de sortie. |
| TextWriterTraceListener(Stream, String) |
Initialise une nouvelle instance de la TextWriterTraceListener classe avec le nom spécifié, en utilisant le flux en tant que destinataire de la sortie de débogage et de suivi. |
| TextWriterTraceListener(Stream) |
Initialise une nouvelle instance de la TextWriterTraceListener classe à l’aide du flux en tant que destinataire de la sortie de débogage et de suivi. |
| TextWriterTraceListener(String, String) |
Initialise une nouvelle instance de la TextWriterTraceListener classe avec le nom spécifié, en utilisant le fichier en tant que destinataire de la sortie de débogage et de suivi. |
| TextWriterTraceListener(String) |
Initialise une nouvelle instance de la TextWriterTraceListener classe à l’aide du fichier en tant que destinataire de la sortie de débogage et de suivi. |
| TextWriterTraceListener(TextWriter, String) |
Initialise une nouvelle instance de la TextWriterTraceListener classe avec le nom spécifié, en utilisant l’enregistreur spécifié en tant que destinataire de la sortie de suivi ou de débogage. |
| TextWriterTraceListener(TextWriter) |
Initialise une nouvelle instance de la classe à l’aide TextWriterTraceListener de l’enregistreur spécifié en tant que destinataire de la sortie de suivi ou de débogage. |
Propriétés
| Nom | Description |
|---|---|
| Attributes |
Obtient les attributs d’écouteur de trace personnalisés définis dans le fichier de configuration de l’application. (Hérité de TraceListener) |
| Filter |
Obtient ou définit le filtre de trace pour l’écouteur de trace. (Hérité de TraceListener) |
| IndentLevel |
Obtient ou définit le niveau de retrait. (Hérité de TraceListener) |
| IndentSize |
Obtient ou définit le nombre d’espaces dans un retrait. (Hérité de TraceListener) |
| IsThreadSafe |
Obtient une valeur indiquant si l’écouteur de trace est thread-safe. (Hérité de TraceListener) |
| Name |
Obtient ou définit un nom pour ce TraceListener. (Hérité de TraceListener) |
| NeedIndent |
Obtient ou définit une valeur indiquant s’il faut mettre en retrait la sortie. (Hérité de TraceListener) |
| TraceOutputOptions |
Obtient ou définit les options de sortie de trace. (Hérité de TraceListener) |
| Writer |
Obtient ou définit l’enregistreur de texte qui reçoit la sortie de suivi ou de débogage. |
Méthodes
| Nom | Description |
|---|---|
| Close() |
Ferme la Writer sortie afin qu’elle ne reçoive plus de suivi ou de débogage. |
| CreateObjRef(Type) |
Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject) |
| Dispose() |
Libère toutes les ressources utilisées par le TraceListener. (Hérité de TraceListener) |
| Dispose(Boolean) |
Supprime cet TextWriterTraceListener objet. |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| Fail(String, String) |
Émet un message d’erreur et un message d’erreur détaillé à l’écouteur que vous créez lorsque vous implémentez la TraceListener classe. (Hérité de TraceListener) |
| Fail(String) |
Émet un message d’erreur à l’écouteur que vous créez lorsque vous implémentez la TraceListener classe. (Hérité de TraceListener) |
| Flush() |
Vide la mémoire tampon de sortie pour le Writer. |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetLifetimeService() |
Obsolète.
Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject) |
| GetSupportedAttributes() |
Obtient les attributs personnalisés pris en charge par l’écouteur de trace. (Hérité de TraceListener) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| InitializeLifetimeService() |
Obsolète.
Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MemberwiseClone(Boolean) |
Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Écrit des informations de trace, un objet de données et des informations d’événement dans la sortie spécifique de l’écouteur. (Hérité de TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Écrit des informations de trace, un tableau d’objets de données et des informations d’événement dans la sortie spécifique de l’écouteur. (Hérité de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Écrit des informations de trace, un tableau mis en forme d’objets et d’informations d’événement dans la sortie spécifique de l’écouteur. (Hérité de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Écrit des informations de trace, un message et des informations d’événement dans la sortie spécifique de l’écouteur. (Hérité de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Écrit les informations de trace et d’événement dans la sortie spécifique de l’écouteur. (Hérité de TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Écrit des informations de trace, un message, une identité d’activité associée et des informations d’événement dans la sortie spécifique de l’écouteur. (Hérité de TraceListener) |
| Write(Object, String) |
Écrit un nom de catégorie et la valeur de la méthode de ToString() l’objet dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe. (Hérité de TraceListener) |
| Write(Object) |
Écrit la valeur de la méthode de ToString() l’objet dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe. (Hérité de TraceListener) |
| Write(String, String) |
Écrit un nom de catégorie et un message dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe. (Hérité de TraceListener) |
| Write(String) |
Écrit un message dans le message de Writercette instance. |
| WriteIndent() |
Écrit le retrait dans l’écouteur que vous créez lorsque vous implémentez cette classe et réinitialise la NeedIndent propriété sur |
| WriteLine(Object, String) |
Écrit un nom de catégorie et la valeur de la méthode de ToString() l’objet dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe, suivie d’un terminateur de ligne. (Hérité de TraceListener) |
| WriteLine(Object) |
Écrit la valeur de la méthode de ToString() l’objet dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe, suivie d’une marque de fin de ligne. (Hérité de TraceListener) |
| WriteLine(String, String) |
Écrit un nom de catégorie et un message dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe, suivi d’un terminateur de ligne. (Hérité de TraceListener) |
| WriteLine(String) |
Écrit un message dans l’instance suivie d’un terminateur de Writer ligne. Le terminateur de ligne par défaut est un retour chariot suivi d’un flux de ligne (\r\n). |
