DelimitedListTraceListener Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Dirigerar spårnings- eller felsökningsutdata till en textskrivare, till exempel en strömskrivare, eller till en ström, till exempel en filström.
public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListenerpublic class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListenertype DelimitedListTraceListener = class
inherit TextWriterTraceListenerPublic Class DelimitedListTraceListener
Inherits TextWriterTraceListener- Arv
- Arv
Kommentarer
Spårningsutdata är i ett avgränsat textformat som använder avgränsare som anges av Delimiter egenskapen. Avgränsare används för att avsluta varje fält i en rad med utdata. Om du till exempel vill visa spårningsutdata i ett Microsoft Excel kalkylblad kan du ange ett kommatecken (",") som avgränsare och skapa en CSV-fil (kommaavgränsat värde).
Important
Den här typen implementerar IDisposable gränssnittet. När du har använt typen bör du kassera den på ett direkt eller indirekt sätt. Om du vill ta bort typen direkt anropar du dess Dispose metod i etttry/catch block. Om du vill ta bort det indirekt använder du en språkkonstruktion som using (i C#) eller Using (i Visual Basic). Mer information finns i avsnittet "Använda ett objekt som implementerar IDisposable" i IDisposable gränssnittet.
Du kan skapa en DelimitedListTraceListener i koden. I .NET Framework-appar kan du också aktivera eller inaktivera en DelimitedListTraceListener via programkonfigurationsfilen och sedan använda den konfigurerade DelimitedListTraceListener i programmet.
Note
Avgränsar DelimitedListTraceListener endast text som genereras med hjälp av de metoder som har namn som börjar med ordet Trace, till exempel DelimitedListTraceListener.TraceEvent eller Trace.TraceWarning. Spårningsdata som genereras med metoderna Debug.Write och TextWriterTraceListener.WriteLine avgränsas inte.
Om du vill konfigurera en DelimitedListTraceListener i en .NET Framework-app redigerar du konfigurationsfilen som motsvarar namnet på ditt program. I den här filen kan du lägga till en lyssnare, ange egenskaperna för en lyssnare eller ta bort en lyssnare. Konfigurationsfilen ska formateras enligt följande exempel:
<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>
Note
Om du försöker skriva till en fil som används eller inte är tillgänglig, prefixas filnamnet automatiskt av ett GUID.
Note
Lyssnare är avsedda att användas med metoder i klasserna Debug, Traceoch TraceSource för att skriva spårningsinformation. Lyssnarmetoder, förutom konstruktorer, bör inte anropas direkt från programkoden.
Konstruktorer
| Name | Description |
|---|---|
| DelimitedListTraceListener(Stream, String) |
Initierar en ny instans av DelimitedListTraceListener klassen som skriver till den angivna utdataströmmen och har det angivna namnet. |
| DelimitedListTraceListener(Stream) |
Initierar en ny instans av DelimitedListTraceListener klassen som skriver till den angivna utdataströmmen. |
| DelimitedListTraceListener(String, String) |
Initierar en ny instans av DelimitedListTraceListener klassen som skriver till den angivna filen och har det angivna namnet. |
| DelimitedListTraceListener(String) |
Initierar en ny instans av DelimitedListTraceListener klassen som skriver till den angivna filen. |
| DelimitedListTraceListener(TextWriter, String) |
Initierar en ny instans av DelimitedListTraceListener klassen som skriver till den angivna textskrivaren och har det angivna namnet. |
| DelimitedListTraceListener(TextWriter) |
Initierar en ny instans av DelimitedListTraceListener klassen som skriver till den angivna textskrivaren. |
Egenskaper
| Name | Description |
|---|---|
| Attributes |
Hämtar attributen för anpassad spårningslyssnare som definierats i programkonfigurationsfilen. (Ärvd från TraceListener) |
| Delimiter |
Hämtar eller anger avgränsare för den avgränsade listan. |
| Filter |
Hämtar eller anger spårningsfiltret för spårningslyssnaren. (Ärvd från TraceListener) |
| IndentLevel |
Hämtar eller anger indragsnivån. (Ärvd från TraceListener) |
| IndentSize |
Hämtar eller anger antalet blanksteg i ett indrag. (Ärvd från TraceListener) |
| IsThreadSafe |
Hämtar ett värde som anger om spårningslyssnaren är trådsäker. (Ärvd från TraceListener) |
| Name |
Hämtar eller anger ett namn för den här TraceListener. (Ärvd från TraceListener) |
| NeedIndent |
Hämtar eller anger ett värde som anger om utdata ska dras in. (Ärvd från TraceListener) |
| TraceOutputOptions |
Hämtar eller anger alternativen för spårningsutdata. (Ärvd från TraceListener) |
| Writer |
Hämtar eller anger den textskrivare som tar emot spårnings- eller felsökningsutdata. (Ärvd från TextWriterTraceListener) |
Metoder
| Name | Description |
|---|---|
| Close() |
Writer Stänger så att den inte längre tar emot spårning eller felsökning av utdata. (Ärvd från TextWriterTraceListener) |
| CreateObjRef(Type) |
Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject) |
| Dispose() |
Släpper alla resurser som används av TraceListener. (Ärvd från TraceListener) |
| Dispose(Boolean) |
Bortser från det här TextWriterTraceListener objektet. (Ärvd från TextWriterTraceListener) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| Fail(String, String) |
Genererar ett felmeddelande och ett detaljerat felmeddelande till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener) |
| Fail(String) |
Genererar ett felmeddelande till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener) |
| Flush() |
Tömer utdatabufferten Writerför . (Ärvd från TextWriterTraceListener) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetLifetimeService() |
Föråldrad.
Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| GetSupportedAttributes() |
Returnerar det anpassade konfigurationsfilattributet som stöds av den avgränsade spårningslyssnaren. |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| InitializeLifetimeService() |
Föråldrad.
Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| MemberwiseClone(Boolean) |
Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Skriver spårningsinformation, ett dataobjekt och händelseinformation till utdatafilen eller strömmen. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Skriver spårningsinformation, en matris med dataobjekt och händelseinformation till utdatafilen eller strömmen. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Skriver spårningsinformation, en formaterad matris med objekt och händelseinformation till utdatafilen eller strömmen. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Skriver spårningsinformation, ett meddelande och händelseinformation till utdatafilen eller strömmen. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Skriver spårnings- och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Skriver spårningsinformation, ett meddelande, en relaterad aktivitetsidentitet och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener) |
| Write(Object, String) |
Skriver ett kategorinamn och värdet för objektets ToString() metod till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener) |
| Write(Object) |
Skriver värdet för objektets ToString() -metod till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener) |
| Write(String, String) |
Skriver ett kategorinamn och ett meddelande till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener) |
| Write(String) |
Skriver ett meddelande till den här instansens Writer. (Ärvd från TextWriterTraceListener) |
| WriteIndent() |
Skriver indraget till lyssnaren som du skapar när du implementerar den här klassen och återställer NeedIndent egenskapen till |
| WriteLine(Object, String) |
Skriver ett kategorinamn och värdet för objektets ToString() metod till lyssnaren som du skapar när du implementerar TraceListener klassen, följt av en radavgränsare. (Ärvd från TraceListener) |
| WriteLine(Object) |
Skriver värdet för objektets ToString() -metod till lyssnaren du skapar när du implementerar TraceListener klassen, följt av en radavslutare. (Ärvd från TraceListener) |
| WriteLine(String, String) |
Skriver ett kategorinamn och ett meddelande till lyssnaren som du skapar när du implementerar TraceListener klassen, följt av en radavgränsare. (Ärvd från TraceListener) |
| WriteLine(String) |
Skriver ett meddelande till den här instansen Writer följt av en radavgränsare. Standardlinjens avslutare är en vagnretur följt av en radmatning (\r\n). (Ärvd från TextWriterTraceListener) |
