FileLogTraceListener.TraceEvent Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.Logging

Sestavení:

Microsoft.VisualBasic.Forms.dll

Zapíše trasování a informace o událostech do výstupního souboru nebo datového proudu.

Přetížení

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapíše trasovací informace, 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 trasovací informace, formátovanou matici objektů a informace o událostech do výstupního souboru nebo datového proudu.

Poznámky

TraceEvent metody nejsou určeny k vyvolání kódem aplikace. Tyto metody jsou volána členy Debugtříd , Tracea TraceSource zapisovat trasovací data do výstupu.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Zapíše trasovací informace, zprávu a informace o událostech do výstupního souboru nebo datového proudu.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);

public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string message);

override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, message As String)

Parametry

eventCache

TraceEventCache

Objekt TraceEventCache , který obsahuje aktuální ID procesu, ID vlákna a informace o trasování zásobníku.

source

String

Název zdroje trasování, který vyvolal tuto metodu.

eventType

TraceEventType

Jedna z hodnot výčtu TraceEventType .

id

Int32

Číselný identifikátor události.

message

String

Zpráva pro zápis

Poznámky

Tato metoda:

1. Formátuje data a kontextové informace pro výstup.

2. V případě potřeby vytvoří nový soubor protokolu.

3. Zapíše informace do souboru protokolu.

Další informace o vytváření nových souborů protokolů najdete v tématu FullLogFileName.

Tato tabulka obsahuje seznam výstupních polí v pořadí, ve kterém se zobrazují. Pole jsou oddělena řetězcem, který Delimiter určuje vlastnost, a jsou následována ukončovacím znakem řádku.

Pole	Výstupní podmínka	Popis
source	Always (Vždy)	Hodnota .name
severity	Always (Vždy)	Název výčtu-hodnota pro eventType.
id	Always (Vždy)	Řetězcová reprezentace .id
message	Always (Vždy)	Hodnota .message
callStack	Callstack Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Vlastnost Callstack .eventCache
CorrelationID	LogicalOperationStack Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Vlastnost ThreadId .eventCache
DateTime	DateTime Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Řetězcová reprezentace DateTime vlastnosti .eventCache Pro převod řetězce se používá invariantní jazyková verze.
ProcessID	ProcessId Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Řetězcová reprezentace ProcessId vlastnosti .eventCache Pro převod řetězce se používá invariantní jazyková verze.
ThreadID	ThreadId Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Vlastnost ThreadId .eventCache
Timestamp	Timestamp Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Řetězcová reprezentace Timestamp vlastnosti .eventCache Pro převod řetězce se používá invariantní jazyková verze.
HostName	IncludeHostName Pokud je Truevlastnost .	Název počítače.

Viz také

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Zapíše trasovací informace, formátovanou matici objektů a informace o událostech do výstupního souboru nebo datového proudu.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);

override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parametry

eventCache

TraceEventCache

Objekt TraceEventCache , který obsahuje aktuální ID procesu, ID vlákna a informace o trasování zásobníku.

source

String

Název zdroje trasování, který vyvolal tuto metodu.

eventType

TraceEventType

Jedna z hodnot výčtu TraceEventType .

id

Int32

Číselný identifikátor události.

format

String

Formátovací řetězec, který obsahuje nula nebo více položek formátu, které odpovídají objektům args v poli.

args

Object[]

Pole Object obsahující nula nebo více objektů, které se mají formátovat.

Poznámky

Tato metoda:

1. Formátuje data a kontextové informace pro výstup.

2. V případě potřeby vytvoří nový nový soubor protokolu.

3. Zapíše informace do souboru protokolu.

Další informace o vytváření nového souboru protokolu najdete v tématu FullLogFileName.

Tato tabulka obsahuje seznam výstupních polí v pořadí, ve kterém se zobrazují. Pole jsou oddělena řetězcem, který Delimiter vlastnost určuje, a za ním je ukončovací znak řádku.

Pole	Výstupní podmínka	Popis
source	Vždy	Hodnota .name
severity	Vždy	Název výčtu-hodnota pro eventType.
id	Vždy	Řetězcová reprezentace .id
message	Vždy	Data formátovaná args pomocí format řetězce a použití invariantní jazykové verze pro převody řetězců.
callStack	Callstack Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Vlastnost Callstack .eventCache
CorrelationID	LogicalOperationStack Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Vlastnost ThreadId .eventCache
DateTime	DateTime Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Řetězcová reprezentace DateTime vlastnosti .eventCache Pro převod řetězce se používá invariantní jazyková verze.
ProcessID	ProcessId Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Řetězcová reprezentace ProcessId vlastnosti .eventCache Pro převod řetězce se používá invariantní jazyková verze.
ThreadID	ThreadId Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Vlastnost ThreadId .eventCache
Timestamp	Timestamp Pokud je příznak nastaven ve TraceOutputOptions vlastnosti.	Řetězcová reprezentace Timestamp vlastnosti .eventCache Pro převod řetězce se používá invariantní jazyková verze.
HostName	IncludeHostName Pokud je Truevlastnost .	Název počítače.

Viz také

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType