DelimitedListTraceListener 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 la sortie de trace ou de débogage vers un TextWriter, tel qu'un writer de flux, ou vers un flux, tel qu'un flux de fichier.
public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListenerpublic class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListenertype DelimitedListTraceListener = class
inherit TextWriterTraceListenerPublic Class DelimitedListTraceListener
Inherits TextWriterTraceListener- Héritage
- Héritage
Remarques
La sortie de trace a un format de texte délimité qui utilise le délimiteur spécifié par la propriété Delimiter. Le délimiteur est utilisé pour arrêter chaque champ d’une ligne de sortie. Par exemple, pour afficher la sortie de trace dans une feuille de calcul Microsoft Excel, vous pouvez spécifier une virgule (« , ») en tant que délimiteur et créer un fichier de valeurs séparées par des virgules (CSV).
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 le type directement, appelez sa Dispose méthode dans untry/catch bloc. Pour la supprimer indirectement, utilisez une construction de langage telle que using (dans C#) ou Using (dans Visual Basic). Pour plus d’informations, consultez la section « Utilisation d’un objet qui implémente IDisposable » dans la rubrique de l’interface IDisposable.
Vous pouvez créer un DelimitedListTraceListener dans votre code. Sinon, dans les applications .NET Framework uniquement, vous pouvez activer ou désactiver un via le fichier de configuration de DelimitedListTraceListener l’application, puis utiliser le configuré DelimitedListTraceListener dans votre application.
Notes
Le DelimitedListTraceListener délimite uniquement le texte émis à l’aide des méthodes qui ont des noms commençant par le mot Trace, tels que DelimitedListTraceListener.TraceEvent ou Trace.TraceWarning. Les données de trace émises à l’aide des Debug.Write méthodes et TextWriterTraceListener.WriteLine ne sont pas délimitées.
Pour configurer un DelimitedListTraceListener 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 les propriétés d’un écouteur ou supprimer un écouteur. Le fichier de configuration doit être mis en forme comme indiqué dans l’exemple suivant :
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="delimitedListener"
type="System.Diagnostics.DelimitedListTraceListener"
delimiter=","
initializeData="delimitedOutput.csv"
traceOutputOptions="ProcessId, DateTime" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Notes
Si vous essayez d’écrire dans un fichier qui est en cours d’utilisation ou non disponible, le nom de fichier est automatiquement précédé d’un GUID.
Notes
Les écouteurs sont destinés à être utilisés par les Debugméthodes des classes , Traceet TraceSource pour écrire des informations de trace. Les méthodes d’écouteur, à l’exception des constructeurs, ne doivent pas être appelées directement à partir du code d’application.
Constructeurs
| DelimitedListTraceListener(Stream) |
Initialise une nouvelle instance de la classe DelimitedListTraceListener qui écrit dans le flux de sortie spécifié. |
| DelimitedListTraceListener(Stream, String) |
Initialise une nouvelle instance de la classe DelimitedListTraceListener qui écrit dans le flux de sortie spécifié et possède le nom spécifié. |
| DelimitedListTraceListener(String) |
Initialise une nouvelle instance de la classe DelimitedListTraceListener qui écrit dans le fichier spécifié. |
| DelimitedListTraceListener(String, String) |
Initialise une nouvelle instance de la classe DelimitedListTraceListener qui écrit dans le fichier spécifié et possède le nom spécifié. |
| DelimitedListTraceListener(TextWriter) |
Initialise une nouvelle instance de la classe DelimitedListTraceListener qui écrit dans le TextWriter spécifié. |
| DelimitedListTraceListener(TextWriter, String) |
Initialise une nouvelle instance de la classe DelimitedListTraceListener qui écrit dans le TextWriter spécifié et possède le nom spécifié. |
Propriétés
| Attributes |
Obtient les attributs d'écouteur de trace personnalisés définis dans le fichier de configuration de l'application. (Hérité de TraceListener) |
| Delimiter |
Obtient ou définit le délimiteur pour la liste délimitée. |
| Filter |
Obtient ou définit le filtre de trace pour l’écouteur de la 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 qui indique 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 si la sortie doit être mise en retrait. (Hérité de TraceListener) |
| TraceOutputOptions |
Obtient ou définit les options de sortie de trace. (Hérité de TraceListener) |
| Writer |
Obtient ou définit TextWriter qui reçoit la sortie de traçage ou de débogage. (Hérité de TextWriterTraceListener) |
Méthodes
| Close() |
Ferme Writer pour qu'il ne reçoive plus la sortie de traçage ou de débogage. (Hérité de TextWriterTraceListener) |
| CreateObjRef(Type) |
Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject) |
| Dispose() |
Libère toutes les ressources utilisées par TraceListener. (Hérité de TraceListener) |
| Dispose(Boolean) |
Supprime cet objet TextWriterTraceListener. (Hérité de TextWriterTraceListener) |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| Fail(String) |
Émet un message d'erreur à l'écouteur que vous créez lors de l'implémentation de la classe TraceListener. (Hérité de TraceListener) |
| Fail(String, String) |
Émet un message d'erreur, ainsi qu'un message d'erreur détaillé, à l'écouteur que vous créez lors de l'implémentation de la classe TraceListener. (Hérité de TraceListener) |
| Flush() |
Vide la mémoire tampon de sortie du Writer. (Hérité de TextWriterTraceListener) |
| GetHashCode() |
Fait office 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 en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject) |
| GetSupportedAttributes() |
Retourne l'attribut de fichier de configuration personnalisé pris en charge par l'écouteur de la trace délimité. |
| GetSupportedAttributes() |
Obtient les attributs personnalisés pris en charge par l'écouteur de trace. (Hérité de TraceListener) |
| GetType() |
Obtient le 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 Object actuel. (Hérité de Object) |
| MemberwiseClone(Boolean) |
Crée une copie superficielle de l'objet MarshalByRefObject actuel. (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 traçage, un objet de données et des informations d'événement dans le fichier ou le flux de sortie. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Écrit des informations de traçage, un tableau d'objets de données et des informations d'événement dans le fichier ou le flux de sortie. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Écrit les informations sur la trace et les événements dans la sortie spécifique de l'écouteur. (Hérité de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Écrit des informations de traçage, un message et des informations d'événement dans le fichier ou le flux de sortie. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Écrit des informations de traçage, un tableau d'objets mis en forme et des informations d'événement dans le fichier ou le flux de sortie. |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Écrit les informations sur la trace, un message, une identité d'activité connexe et les informations sur les événements dans la sortie spécifique de l'écouteur. (Hérité de TraceListener) |
| Write(Object) |
Écrit la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener. (Hérité de TraceListener) |
| Write(Object, String) |
Écrit un nom de catégorie ou la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener. (Hérité de TraceListener) |
| Write(String) |
Écrit un message dans le Writer de cette instance. (Hérité de TextWriterTraceListener) |
| Write(String, String) |
Écrit un nom de catégorie et un message dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener. (Hérité de TraceListener) |
| WriteIndent() |
Écrit la mise en retrait dans l'écouteur que vous créez lors de l'implémentation de cette classe et rétablit la valeur |
| WriteLine(Object) |
Écrit la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivie d'une marque de fin de ligne. (Hérité de TraceListener) |
| WriteLine(Object, String) |
Écrit un nom de catégorie ou la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivis d'une marque de fin de ligne. (Hérité de TraceListener) |
| WriteLine(String) |
Écrit un message suivi d'un terminateur de ligne sur le Writer de cette instance. La ligne se termine par défaut par un retour chariot suivi d'un changement de ligne (\r\n). (Hérité de TextWriterTraceListener) |
| WriteLine(String, String) |
Écrit un nom de catégorie ou un message dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivis d'une marque de fin de ligne. (Hérité de TraceListener) |
S’applique à
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour