TraceListener Klass

Definition

Namnområde:
System.Diagnostics
Sammansättningar:
netstandard.dll, System.Diagnostics.TraceSource.dll
Sammansättning:
System.Diagnostics.TraceSource.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll
Källa:
TraceListener.cs
Källa:
TraceListener.cs
Källa:
TraceListener.cs
Källa:
TraceListener.cs
Källa:
TraceListener.cs

Tillhandahåller basklassen abstract för lyssnarna som övervakar spårnings- och felsökningsutdata.

public ref class TraceListener abstract : MarshalByRefObject, IDisposable
public ref class TraceListener abstract : IDisposable
public abstract class TraceListener : MarshalByRefObject, IDisposable
public abstract class TraceListener : IDisposable
type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable
type TraceListener = class
    interface IDisposable
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
Public MustInherit Class TraceListener
Implements IDisposable
Arv
Object
MarshalByRefObject
TraceListener
Arv
Object
TraceListener
Härledda
Implementeringar
IDisposable

Kommentarer

Exempel på hur du implementerar en TraceListenerfinns i klasserna DefaultTraceListener, TextWriterTraceListener och EventLogTraceListener .

Du måste aktivera spårning eller felsökning för att kunna använda en spårningslyssnare. Följande syntax är kompilatorspecifik. Om du använder andra kompilatorer än C# eller Visual Basic läser du dokumentationen för kompilatorn.

  • Om du vill aktivera felsökning i C# lägger du till /d:DEBUG flaggan på kommandoraden för kompilatorn när du kompilerar koden, eller så kan du lägga till #define DEBUG överst i filen. I Visual Basic lägger du till flaggan /d:DEBUG=True på kommandoraden för kompilatorn.

  • Om du vill aktivera spårning i C# lägger du till /d:TRACE flaggan på kommandoraden för kompilatorn när du kompilerar koden eller lägger till #define TRACE den överst i filen. I Visual Basic lägger du till flaggan /d:TRACE=True på kommandoraden för kompilatorn.

Om du vill lägga till en spårningslyssnare redigerar du konfigurationsfilen som motsvarar namnet på ditt program. I den här filen kan du lägga till en lyssnare, ange dess typ och ange dess parameter, ta bort en lyssnare eller rensa alla lyssnare som tidigare angetts av programmet. Konfigurationsfilen ska formateras på liknande sätt som i följande exempel.

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

Mer information om hur du använder konfigurationsfiler för spårning finns i <system.diagnostics>.

Anteckningar till implementerare

Ärver från den här klassen för att implementera en anpassad lyssnare för klasserna Debug och Trace . Du måste minst implementera Write(String) metoderna och WriteLine(String) . Dessutom kan du implementera Fail(String)metoderna , Close() och Flush() .

Konstruktorer

Name Description
TraceListener()

Initierar en ny instans av TraceListener klassen.
TraceListener(String)

Initierar en ny instans av TraceListener klassen med det angivna namnet som lyssnare.

Egenskaper

Name Description
Attributes

Hämtar attributen för anpassad spårningslyssnare som definierats i programkonfigurationsfilen.
Filter

Hämtar eller anger spårningsfiltret för spårningslyssnaren.
IndentLevel

Hämtar eller anger indragsnivån.
IndentSize

Hämtar eller anger antalet blanksteg i ett indrag.
IsThreadSafe

Hämtar ett värde som anger om spårningslyssnaren är trådsäker.
Name

Hämtar eller anger ett namn för den här TraceListener.
NeedIndent

Hämtar eller anger ett värde som anger om utdata ska dras in.
TraceOutputOptions

Hämtar eller anger alternativen för spårningsutdata.

Metoder

Name Description
Close()

När den åsidosätts i en härledd klass stänger utdataströmmen så att den inte längre tar emot spårning eller felsökning av utdata.
CreateObjRef(Type)

Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt.

(Ärvd från MarshalByRefObject)
Dispose()

Släpper alla resurser som används av TraceListener.
Dispose(Boolean)

Släpper de ohanterade resurser som används av TraceListener och släpper eventuellt de hanterade resurserna.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
Fail(String, String)

Genererar ett felmeddelande och ett detaljerat felmeddelande till lyssnaren som du skapar när du implementerar TraceListener klassen.
Fail(String)

Genererar ett felmeddelande till lyssnaren som du skapar när du implementerar TraceListener klassen.
Flush()

När den åsidosättas i en härledd klass töms utdatabufferten.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetLifetimeService()
Föråldrad.

Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
GetSupportedAttributes()

Hämtar anpassade attribut som stöds av spårningslyssnaren.
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
InitializeLifetimeService()
Föråldrad.

Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
MemberwiseClone(Boolean)

Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet.

(Ärvd från MarshalByRefObject)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Skriver spårningsinformation, ett dataobjekt och händelseinformation till lyssnarens specifika utdata.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Skriver spårningsinformation, en matris med dataobjekt och händelseinformation till lyssnarens specifika utdata.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Skriver spårningsinformation, en formaterad matris med objekt och händelseinformation till lyssnarens specifika utdata.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Skriver spårningsinformation, ett meddelande och händelseinformation till lyssnarens specifika utdata.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Skriver spårnings- och händelseinformation till lyssnarens specifika utdata.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Skriver spårningsinformation, ett meddelande, en relaterad aktivitetsidentitet och händelseinformation till lyssnarens specifika utdata.
Write(Object, String)

Skriver ett kategorinamn och värdet för objektets ToString() metod till lyssnaren som du skapar när du implementerar TraceListener klassen.
Write(Object)

Skriver värdet för objektets ToString() -metod till lyssnaren som du skapar när du implementerar TraceListener klassen.
Write(String, String)

Skriver ett kategorinamn och ett meddelande till lyssnaren som du skapar när du implementerar TraceListener klassen.
Write(String)

När du åsidosättas i en härledd klass skriver du det angivna meddelandet till lyssnaren som du skapar i den härledda klassen.
WriteIndent()

Skriver indraget till lyssnaren som du skapar när du implementerar den här klassen och återställer NeedIndent egenskapen till false.
WriteLine(Object, String)

Skriver ett kategorinamn och värdet för objektets ToString() metod till lyssnaren som du skapar när du implementerar TraceListener klassen, följt av en radavgränsare.
WriteLine(Object)

Skriver värdet för objektets ToString() -metod till lyssnaren du skapar när du implementerar TraceListener klassen, följt av en radavslutare.
WriteLine(String, String)

Skriver ett kategorinamn och ett meddelande till lyssnaren som du skapar när du implementerar TraceListener klassen, följt av en radavgränsare.
WriteLine(String)

När du åsidosättas i en härledd klass skriver du ett meddelande till lyssnaren som du skapar i den härledda klassen, följt av en radavgränsare.

Gäller för

Trådsäkerhet

Den här typen är trådsäker.

Se även