DelimitedListTraceListener Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.TextWriterTraceListener.dll

Zdroj:

DelimitedListTraceListener.cs

Směruje trasování nebo ladění výstupu do textového zapisovače, jako je zapisovač streamu, nebo do datového proudu, jako je stream souboru.

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 v textovém formátu s oddělovačem, který je určen vlastnostmi Delimiter. Oddělovač slouží k ukončení každého pole v řádku výstupu. Pokud chcete například zobrazit výstup trasování v tabulce Microsoft Excelu, můžete jako oddělovač zadat čárku (",") a vytvořit soubor hodnot oddělených čárkami (CSV).

Důležité

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

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

Poznámka:

Odděluje DelimitedListTraceListener pouze text, který je generován pomocí metod, které mají názvy začínající slovem Trace, například DelimitedListTraceListener.TraceEvent nebo Trace.TraceWarning. Trasování dat, která se vygenerují pomocí Debug.Write metod, TextWriterTraceListener.WriteLine nejsou oddělena.

Chcete-li 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 naformátovaný, 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 zapsat do souboru, který se používá nebo není k dispozici, název souboru je automaticky předponou identifikátoru GUID.

Poznámka:

Naslouchací procesy jsou určeny k použití metodami Debug, Tracea TraceSource třídy k zápisu informací trasování. Metody naslouchacího procesu s výjimkou konstruktorů by neměly být volána přímo z kódu aplikace.

Konstruktory

Name	Description
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(Stream)	Inicializuje novou instanci DelimitedListTraceListener třídy, která zapisuje do zadaného výstupního datového proudu.
DelimitedListTraceListener(String, String)	Inicializuje novou instanci DelimitedListTraceListener třídy, která zapisuje do zadaného souboru a má zadaný název.
DelimitedListTraceListener(String)	Inicializuje novou instanci DelimitedListTraceListener třídy, která zapisuje do zadaného souboru.
DelimitedListTraceListener(TextWriter, String)	Inicializuje novou instanci DelimitedListTraceListener třídy, která zapisuje do zadaného textového zapisovače a má zadaný název.
DelimitedListTraceListener(TextWriter)	Inicializuje novou instanci DelimitedListTraceListener třídy, která zapisuje do zadaného textového zapisovače.

Vlastnosti

Name	Description
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č pro seznam s oddělovači.
Filter	Získá nebo nastaví filtr trasování pro naslouchací proces trasování. (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 je naslouchací proces trasování bezpečný podproces. (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 se má výstup odsadit. (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ý přijímá trasování nebo ladění výstupu. (Zděděno od TextWriterTraceListener)

Metody

Name	Description
Close()	Writer Zavře tak, aby přestal přijímat výstup trasování nebo ladění. (Zděděno od TextWriterTraceListener)
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čuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
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)
Fail(String)	Vygeneruje 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í funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, 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()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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)	Zapisuje 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 informace o trasování, pole datových objektů a informace o událostech do výstupního souboru nebo datového proudu.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Zapisuje informace o trasování, formátované pole objektů a informace o událostech do výstupního souboru nebo datového proudu.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapíše informace o trasování, zprávu a informace o události do výstupního souboru nebo datového proudu.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Zapíše informace o trasování a událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Zapisuje 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, 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(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(String, String)	Zapíše název kategorie a zprávu 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 této instance Writer. (Zděděno od TextWriterTraceListener)
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, 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(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 řádkem. (Zděděno od TraceListener)
WriteLine(String, String)	Zapíše název kategorie a zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím řádkem. (Zděděno od TraceListener)
WriteLine(String)	Zapíše zprávu do koncového řádku této instance Writer . Výchozí ukončovací znak řádku je návrat na začátek řádku následovaný podáváním (\r\n). (Zděděno od TextWriterTraceListener)