DelimitedListTraceListener Klasa

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.TextWriterTraceListener.dll

Źródło:

DelimitedListTraceListener.cs

Kieruje dane wyjściowe śledzenia lub debugowania do składnika zapisywania tekstu, takiego jak składnik zapisywania strumienia, albo do strumienia, takiego jak strumień pliku.

public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListener

public class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListener

type DelimitedListTraceListener = class
    inherit TextWriterTraceListener

Public Class DelimitedListTraceListener
Inherits TextWriterTraceListener

Dziedziczenie

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

DelimitedListTraceListener

Uwagi

Dane wyjściowe śledzenia są w formacie tekstowym rozdzielanym, który używa ogranicznika określonego Delimiter przez właściwość . Ogranicznik służy do kończenie każdego pola w wierszu danych wyjściowych. Na przykład aby wyświetlić dane wyjściowe śledzenia w arkuszu kalkulacyjnym programu Microsoft Excel, możesz określić przecinek (",") jako ogranicznik i utworzyć plik wartości rozdzielanych przecinkami (CSV).

Ważne

Ten typ implementuje IDisposable interfejs. Po zakończeniu korzystania z typu należy usunąć go bezpośrednio lub pośrednio. Aby bezpośrednio usunąć typ, wywołaj jego Dispose metodętry/catch w bloku. Aby usunąć go pośrednio, użyj konstrukcji języka, takiej jak using (w języku C#) lub Using (w Visual Basic). Aby uzyskać więcej informacji, zobacz sekcję "Using an Object that Implements IDisposable" (Używanie obiektu implementujące interfejs IDisposable) w temacie interfejsu IDisposable .

Możesz utworzyć element DelimitedListTraceListener w kodzie. Alternatywnie tylko w aplikacjach .NET Framework można włączyć lub wyłączyć DelimitedListTraceListener za pośrednictwem pliku konfiguracji aplikacji, a następnie użyć skonfigurowanego DelimitedListTraceListener w aplikacji.

Uwaga

Ogranicznikami DelimitedListTraceListener jest tylko tekst emitowany przy użyciu metod, które mają nazwy rozpoczynające się od słowa Trace, takiego jak DelimitedListTraceListener.TraceEvent lub Trace.TraceWarning. Dane śledzenia emitowane przy użyciu Debug.Write metod i TextWriterTraceListener.WriteLine nie są rozdzielane.

Aby skonfigurować aplikację DelimitedListTraceListener w .NET Framework, zmodyfikuj plik konfiguracji odpowiadający nazwie aplikacji. W tym pliku można dodać odbiornik, ustawić właściwości odbiornika lub usunąć odbiornik. Plik konfiguracji powinien być sformatowany, jak pokazano w poniższym przykładzie:

<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>  

Uwaga

Jeśli spróbujesz zapisać w pliku, który jest używany lub niedostępny, nazwa pliku jest automatycznie poprzedzona identyfikatorem GUID.

Uwaga

Odbiorniki mają być używane przez metody Debugklasy , Tracei TraceSource do zapisywania informacji śledzenia. Metody odbiornika, z wyjątkiem konstruktorów, nie powinny być wywoływane bezpośrednio z kodu aplikacji.

Konstruktory

DelimitedListTraceListener(Stream)	Inicjuje DelimitedListTraceListener nowe wystąpienie klasy, która zapisuje dane do określonego strumienia wyjściowego.
DelimitedListTraceListener(Stream, String)	Inicjuje DelimitedListTraceListener nowe wystąpienie klasy, która zapisuje do określonego strumienia wyjściowego i ma określoną nazwę.
DelimitedListTraceListener(String)	Inicjuje DelimitedListTraceListener nowe wystąpienie klasy, która zapisuje w określonym pliku.
DelimitedListTraceListener(String, String)	Inicjuje DelimitedListTraceListener nowe wystąpienie klasy, która zapisuje w określonym pliku i ma określoną nazwę.
DelimitedListTraceListener(TextWriter)	Inicjuje DelimitedListTraceListener nowe wystąpienie klasy, która zapisuje w określonym składniku zapisywania tekstu.
DelimitedListTraceListener(TextWriter, String)	Inicjuje DelimitedListTraceListener nowe wystąpienie klasy, która zapisuje w określonym składniku zapisywania tekstu i ma określoną nazwę.

Właściwości

Attributes	Pobiera atrybuty niestandardowego odbiornika śledzenia zdefiniowane w pliku konfiguracji aplikacji. (Odziedziczone po TraceListener)
Delimiter	Pobiera lub ustawia ogranicznik listy rozdzielanych.
Filter	Pobiera lub ustawia filtr śledzenia dla odbiornika śledzenia. (Odziedziczone po TraceListener)
IndentLevel	Pobiera lub ustawia poziom wcięcia. (Odziedziczone po TraceListener)
IndentSize	Pobiera lub ustawia liczbę spacji w wcięcie. (Odziedziczone po TraceListener)
IsThreadSafe	Pobiera wartość wskazującą, czy odbiornik śledzenia jest bezpieczny wątkiem. (Odziedziczone po TraceListener)
Name	Pobiera lub ustawia nazwę dla tego TraceListenerelementu . (Odziedziczone po TraceListener)
NeedIndent	Pobiera lub ustawia wartość wskazującą, czy wcięć dane wyjściowe. (Odziedziczone po TraceListener)
TraceOutputOptions	Pobiera lub ustawia opcje danych wyjściowych śledzenia. (Odziedziczone po TraceListener)
Writer	Pobiera lub ustawia moduł zapisywania tekstu, który odbiera dane wyjściowe śledzenia lub debugowania. (Odziedziczone po TextWriterTraceListener)

Metody

Close()	Zamyka element Writer , aby nie odbierał już danych wyjściowych śledzenia ani debugowania. (Odziedziczone po TextWriterTraceListener)
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element TraceListener. (Odziedziczone po TraceListener)
Dispose(Boolean)	Usuwa ten TextWriterTraceListener obiekt. (Odziedziczone po TextWriterTraceListener)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Fail(String)	Emituje komunikat o błędzie do odbiornika utworzonego podczas implementowania TraceListener klasy . (Odziedziczone po TraceListener)
Fail(String, String)	Emituje komunikat o błędzie i szczegółowy komunikat o błędzie do odbiornika tworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
Flush()	Opróżnia bufor wyjściowy dla elementu Writer. (Odziedziczone po TextWriterTraceListener)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetSupportedAttributes()	Zwraca atrybut niestandardowego pliku konfiguracji obsługiwany przez rozdzielany odbiornik śledzenia.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Zapisuje informacje śledzenia, obiekt danych i informacje o zdarzeniu do pliku wyjściowego lub strumienia.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapisuje informacje śledzenia, tablicę obiektów danych i informacje o zdarzeniach do pliku wyjściowego lub strumienia.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Zapisuje informacje o śledzeniu i zdarzeniu do danych wyjściowych specyficznych dla odbiornika. (Odziedziczone po TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapisuje informacje śledzenia, komunikat i informacje o zdarzeniu do pliku wyjściowego lub strumienia.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Zapisuje informacje śledzenia, sformatowaną tablicę obiektów i informacje o zdarzeniach do pliku wyjściowego lub strumienia.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Zapisuje informacje śledzenia, komunikat, powiązaną tożsamość działania i informacje o zdarzeniu do danych wyjściowych specyficznych dla odbiornika. (Odziedziczone po TraceListener)
Write(Object)	Zapisuje wartość metody obiektu ToString() w odbiorniku tworzonym podczas implementowania TraceListener klasy . (Odziedziczone po TraceListener)
Write(Object, String)	Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
Write(String)	Zapisuje komunikat w wystąpieniu Writer. (Odziedziczone po TextWriterTraceListener)
Write(String, String)	Zapisuje nazwę kategorii i komunikat do odbiornika utworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
WriteIndent()	Zapisuje wcięcie do odbiornika utworzonego podczas implementowania tej klasy i resetuje NeedIndent właściwość do falseklasy . (Odziedziczone po TraceListener)
WriteLine(Object)	Zapisuje wartość metody obiektu ToString() w odbiorniku tworzonym podczas implementowania TraceListener klasy, a po niej następuje terminator wiersza. (Odziedziczone po TraceListener)
WriteLine(Object, String)	Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy, a następnie terminator wiersza. (Odziedziczone po TraceListener)
WriteLine(String)	Zapisuje komunikat w wystąpieniu, Writer po którym następuje terminator wiersza. Domyślny terminator wiersza to powrót karetki, po którym następuje źródło wiersza (\r\n). (Odziedziczone po TextWriterTraceListener)
WriteLine(String, String)	Zapisuje nazwę kategorii i komunikat do odbiornika tworzonego TraceListener podczas implementowania klasy, po którym następuje terminator wiersza. (Odziedziczone po TraceListener)