DelimitedListTraceListener Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.TextWriterTraceListener.dll

Zdroj:

DelimitedListTraceListener.cs

Směruje výstup trasování nebo ladění do zapisovače textu, jako je zapisovač datového proudu, nebo do datového proudu, jako je filestream.

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

public class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListener

type DelimitedListTraceListener = class
    inherit TextWriterTraceListener

Public Class DelimitedListTraceListener
Inherits TextWriterTraceListener

Dědičnost

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

DelimitedListTraceListener

Poznámky

Výstup trasování je ve formátu textu s oddělovači, který používá oddělovač určený Delimiter vlastností . Oddělovač se používá k ukončení každého pole ve výstupním řádku. Pokud chcete například zobrazit výstup trasování v tabulce Microsoft Excelu, můžete jako oddělovač zadat čárku (",") a vytvořit soubor s hodnotami oddělenými čárkami (CSV).

Důležité

Tento typ implementuje IDisposable rozhraní . Až s použitím typu skončíte, měli byste ho odstranit přímo nebo nepřímo. Chcete-li odstranit typ přímo, zavolejte jeho Dispose metodutry/catch v bloku. Pokud ho chcete odstranit nepřímo, použijte konstruktor jazyka, jako using je (v jazyce C#) nebo Using (v jazyce Visual Basic). Další informace najdete v části "Použití objektu, který implementuje IDisposable" v IDisposable tématu rozhraní.

V kódu můžete vytvořit .DelimitedListTraceListener Alternativně můžete povolit nebo zakázat DelimitedListTraceListener prostřednictvím konfiguračního souboru aplikace pouze v aplikacích .NET Framework a pak použít nakonfigurovaný DelimitedListTraceListener soubor ve vaší aplikaci.

Poznámka

Objekt DelimitedListTraceListener ohraničuje pouze text, který je vygenerován pomocí metod, které mají názvy začínající slovem Trace, například DelimitedListTraceListener.TraceEvent nebo Trace.TraceWarning. Trasování dat generovaných pomocí Debug.Write metod a TextWriterTraceListener.WriteLine není odděleno.

Pokud chcete nakonfigurovat DelimitedListTraceListener v aplikaci .NET Framework, upravte konfigurační soubor, který odpovídá názvu vaší aplikace. V tomto souboru můžete přidat naslouchací proces, nastavit vlastnosti naslouchacího procesu nebo odebrat naslouchací proces. Konfigurační soubor by měl být formátovaný tak, jak je znázorněno v následujícím příkladu:

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

Poznámka

Pokud se pokusíte zapisovat do souboru, který se používá nebo není k dispozici, název souboru bude automaticky předponou guid.

Poznámka

Naslouchací Debugprocesy jsou určeny k použití metodami tříd , Tracea TraceSource k zápisu trasovacích informací. Metody naslouchacího procesu, s výjimkou konstruktorů, by neměly být volávány přímo z kódu aplikace.

Konstruktory

DelimitedListTraceListener(Stream)	Inicializuje novou instanci DelimitedListTraceListener třídy, která zapisuje do zadaného výstupního datového proudu.
DelimitedListTraceListener(Stream, String)	Inicializuje novou instanci DelimitedListTraceListener třídy, která zapisuje do zadaného výstupního datového proudu a má zadaný název.
DelimitedListTraceListener(String)	Inicializuje novou instanci DelimitedListTraceListener třídy, která zapisuje do zadaného souboru.
DelimitedListTraceListener(String, String)	Inicializuje novou instanci DelimitedListTraceListener třídy, která zapisuje do zadaného souboru a má zadaný název.
DelimitedListTraceListener(TextWriter)	Inicializuje novou instanci DelimitedListTraceListener třídy, která zapisuje do zadaného zapisovače textu.
DelimitedListTraceListener(TextWriter, String)	Inicializuje novou instanci DelimitedListTraceListener třídy, která zapisuje do zadaného zapisovače textu a má zadaný název.

Vlastnosti

Attributes	Získá vlastní atributy naslouchacího procesu trasování definované v konfiguračním souboru aplikace. (Zděděno od TraceListener)
Delimiter	Získá nebo nastaví oddělovač seznamu s oddělovači.
Filter	Získá nebo nastaví filtr trasování pro trasování naslouchací proces. (Zděděno od TraceListener)
IndentLevel	Získá nebo nastaví úroveň odsazení. (Zděděno od TraceListener)
IndentSize	Získá nebo nastaví počet mezer v odsazení. (Zděděno od TraceListener)
IsThreadSafe	Získá hodnotu označující, zda trasování naslouchací proces je bezpečný z více vláken. (Zděděno od TraceListener)
Name	Získá nebo nastaví název pro tento TraceListener. (Zděděno od TraceListener)
NeedIndent	Získá nebo nastaví hodnotu označující, zda má být odsazení výstupu. (Zděděno od TraceListener)
TraceOutputOptions	Získá nebo nastaví možnosti výstupu trasování. (Zděděno od TraceListener)
Writer	Získá nebo nastaví zapisovač textu, který obdrží výstup trasování nebo ladění. (Zděděno od TextWriterTraceListener)

Metody

Close()	Writer Zavře tak, aby již nepřijímaly výstup trasování nebo ladění. (Zděděno od TextWriterTraceListener)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem TraceListener. (Zděděno od TraceListener)
Dispose(Boolean)	Odstraní tento TextWriterTraceListener objekt. (Zděděno od TextWriterTraceListener)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Fail(String)	Vygeneruje chybovou zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy . (Zděděno od TraceListener)
Fail(String, String)	Vygeneruje chybovou zprávu a podrobnou chybovou zprávu naslouchacímu procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Flush()	Vyprázdní výstupní vyrovnávací paměť pro Writer. (Zděděno od TextWriterTraceListener)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetSupportedAttributes()	Vrátí atribut vlastního konfiguračního souboru podporovaný naslouchacím procesem trasování s oddělovači.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Zapíše informace o trasování, datový objekt a informace o událostech do výstupního souboru nebo datového proudu.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapisuje trasovací informace, pole datových objektů a informace o událostech do výstupního souboru nebo datového proudu.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Zapíše trasování a informace o událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapíše informace o trasování, zprávu a informace o událostech do výstupního souboru nebo datového proudu.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Zapíše informace o trasování, formátované pole objektů a informace o událostech do výstupního souboru nebo datového proudu.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Zapíše informace o trasování, zprávu, související identitu aktivity a informace o událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener)
Write(Object)	Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Write(Object, String)	Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Write(String)	Zapíše zprávu do instance Writer. (Zděděno od TextWriterTraceListener)
Write(String, String)	Zapíše název kategorie a zprávu naslouchacímu procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
WriteIndent()	Zapíše odsazení do naslouchacího procesu, který vytvoříte při implementaci této třídy, a resetuje NeedIndent vlastnost na false. (Zděděno od TraceListener)
WriteLine(Object)	Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener)
WriteLine(Object, String)	Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener)
WriteLine(String)	Zapíše zprávu na tuto instanci Writer následovanou ukončovacím znakem řádku. Výchozí ukončovací znak řádku je návrat na začátek řádku následovaný odřádkováním (\r\n). (Zděděno od TextWriterTraceListener)
WriteLine(String, String)	Zapíše název kategorie a zprávu naslouchacímu procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener)