TraceListener Osztály

Definíció

Névtér:

System.Diagnostics

Szerelvények:

netstandard.dll, System.Diagnostics.TraceSource.dll

Forrás:

TraceListener.cs

A nyomkövetési abstract és hibakeresési kimenetet figyelő figyelők alaposztályát biztosítja.

public ref class TraceListener abstract : MarshalByRefObject, IDisposable

public abstract class TraceListener : MarshalByRefObject, IDisposable

type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable

Öröklődés

Object

MarshalByRefObject

TraceListener

Származtatott

Microsoft.VisualBasic.Logging.FileLogTraceListener

System.Diagnostics.DefaultTraceListener

System.Diagnostics.Eventing.EventProviderTraceListener

System.Diagnostics.EventLogTraceListener

System.Diagnostics.TextWriterTraceListener

System.Web.IisTraceListener

System.Web.WebPageTraceListener

Megvalósítás

IDisposable

Megjegyzések

Példák a implementálásraTraceListener, lásd az osztályokat és az DefaultTraceListenerTextWriterTraceListenerEventLogTraceListener osztályokat.

A nyomkövetési vagy hibakeresési figyelő használatához engedélyeznie kell a nyomkövetést vagy a hibakeresést. Az alábbi szintaxis fordítóspecifikus. Ha nem C# vagy Visual Basic fordítót használ, tekintse meg a fordító dokumentációját.

• Ha engedélyezni szeretné a hibakeresést a C#-ban, vegye fel a /d:DEBUG jelölőt a fordító parancssorba a kód lefordításakor, vagy felveheti #define DEBUG a fájl tetejére. A Visual Basic adja hozzá a /d:DEBUG=True jelzőt a fordító parancssorához.

• Ha c#-ban szeretné engedélyezni a nyomkövetést, adja hozzá a /d:TRACE jelölőt a fordító parancssorához a kód lefordításakor, vagy vegye fel #define TRACE a fájl tetejére. A Visual Basic adja hozzá a /d:TRACE=True jelzőt a fordító parancssorához.

Nyomkövetési figyelő hozzáadásához szerkessze az alkalmazás nevének megfelelő konfigurációs fájlt. Ebben a fájlban hozzáadhat egy figyelőt, beállíthatja annak típusát és paraméterét, eltávolíthat egy figyelőt, vagy törölheti az alkalmazás által korábban beállított összes figyelőt. A konfigurációs fájlt az alábbi példához hasonlóan kell formázni.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />
        <remove name="Default" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

További információ a konfigurációs fájlok nyomkövetéshez való használatáról: <system.diagnostics>.

Megjegyzések az implementálókhoz

Örökölje ezt az osztályt, hogy egyéni figyelőt implementáljon az és Debug az Trace osztályok számára. Legalább implementálnia kell a metódusokat és Write(String) a WriteLine(String) módszereket. Emellett implementálhatja a metódusokat és Fail(String) a Close()metódusokat Flush() is.

Konstruktorok

Name	Description
TraceListener()	Inicializálja a TraceListener osztály új példányát.
TraceListener(String)	Inicializálja az osztály új példányát a TraceListener megadott névvel figyelőként.

Tulajdonságok

Name	Description
Attributes	Lekéri az alkalmazáskonfigurációs fájlban definiált egyéni nyomkövetésfigyelő attribútumokat.
Filter	Lekéri vagy beállítja a nyomkövetési szűrőt a nyomkövetési figyelőhöz.
IndentLevel	Lekéri vagy beállítja a behúzási szintet.
IndentSize	Lekéri vagy beállítja a behúzásban lévő szóközök számát.
IsThreadSafe	Egy értéket kap, amely jelzi, hogy a nyomkövetési figyelő szálbiztos-e.
Name	Lekéri vagy beállítja ennek TraceListenera névnek a nevét.
NeedIndent	Beolvas vagy beállít egy értéket, amely jelzi, hogy be szeretné-e húzni a kimenetet.
TraceOutputOptions	Lekéri vagy beállítja a nyomkövetési kimeneti beállításokat.

Metódusok

Name	Description
Close()	Ha felülbírál egy származtatott osztályban, bezárja a kimeneti adatfolyamot, hogy többé ne kapja meg a nyomkövetési vagy hibakeresési kimenetet.
Dispose()	Felszabadítja a .-hez használt összes erőforrást TraceListener.
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által TraceListener használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
Fail(String, String)	Hibaüzenetet és részletes hibaüzenetet küld az osztály megvalósításakor TraceListener létrehozott figyelőnek.
Fail(String)	Hibaüzenetet küld az osztály megvalósításakor létrehozott figyelőnek TraceListener .
Flush()	Ha egy származtatott osztályban felül van bírálva, kiüríti a kimeneti puffert.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Elavult. Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetSupportedAttributes()	Lekéri a nyomkövetési figyelő által támogatott egyéni attribútumokat.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
InitializeLifetimeService()	Elavult. Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Nyomkövetési információkat, adatobjektumokat és eseményadatokat ír a figyelő adott kimenetére.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Nyomkövetési információkat, adatobjektumokat és eseményinformációkat tartalmazó tömböt ír a figyelő adott kimenetére.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Nyomkövetési információkat, egy formázott objektumtömböt és eseményinformációt ír a figyelő adott kimenetére.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Nyomkövetési információkat, üzenetet és eseményadatokat ír a figyelő adott kimenetére.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Nyomkövetési és eseményinformációkat ír a figyelő adott kimenetére.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Nyomkövetési információkat, üzenetet, kapcsolódó tevékenységidentitást és eseményadatokat ír a figyelő adott kimenetére.
Write(Object, String)	Kategórianevet és az objektum ToString() metódusának értékét írja az osztály megvalósításakor TraceListener létrehozott figyelőnek.
Write(Object)	Az objektum ToString() metódusának értékét az osztály megvalósításakor TraceListener létrehozott figyelőnek írja.
Write(String, String)	Kategórianevet és üzenetet ír az osztály megvalósításakor TraceListener létrehozott figyelőnek.
Write(String)	Ha felül van bírálva egy származtatott osztályban, a megadott üzenetet a származtatott osztályban létrehozott figyelőnek írja.
WriteIndent()	Az osztály megvalósításakor létrehozott figyelőbe írja a behúzást, és alaphelyzetbe állítja a NeedIndent tulajdonságot false.
WriteLine(Object, String)	Egy kategórianevet és az objektum ToString() metódusának értékét írja az osztály megvalósításakor TraceListener létrehozott figyelőnek, amelyet egy sor terminátor követ.
WriteLine(Object)	Az objektum ToString() metódusának értékét az osztály megvalósításakor TraceListener létrehozott figyelőnek írja, amelyet egy sor terminátor követ.
WriteLine(String, String)	Egy kategórianevet és egy üzenetet ír a figyelőnek, amelyet az TraceListener osztály megvalósításakor hoz létre, majd egy sor terminátort.
WriteLine(String)	Ha felül van bírálva egy származtatott osztályban, üzenetet ír a származtatott osztályban létrehozott figyelőnek, amelyet egy sor terminátor követ.

Szálbiztonság

Ez a típus szálbiztos.

Lásd még

• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace
• <system.diagnostics> elem