TextWriterTraceListener Osztály

Definíció

Névtér:

System.Diagnostics

Szerelvények:

netstandard.dll, System.Diagnostics.TextWriterTraceListener.dll

Forrás:

TextWriterTraceListener.cs

A kimenet nyomon követését vagy hibakeresését irányítja egy TextWriter vagy több Stream, például FileStream.

public ref class TextWriterTraceListener : System::Diagnostics::TraceListener

public class TextWriterTraceListener : System.Diagnostics.TraceListener

type TextWriterTraceListener = class
    inherit TraceListener

Public Class TextWriterTraceListener
Inherits TraceListener

Öröklődés

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

Származtatott

System.Diagnostics.ConsoleTraceListener

System.Diagnostics.DelimitedListTraceListener

System.Diagnostics.EventSchemaTraceListener

System.Diagnostics.XmlWriterTraceListener

Példák

Az alábbi példa az osztály egy olyan példányát TextWriterTraceListener implementálja, amely meghívva StreamWritermyOutputWriter ír egy nevesített TestFile.txtfájlba. Először a példa létrehoz egy fájlt a kimenethez. Ezután létrehozza az StreamWriter első szövegírót, hozzárendeli a kimeneti fájlt, és hozzáadja a Listenersfájlhoz. Ezután a kód egy sornyi szöveget ad ki a fájlba. Végül a példa kiüríti a kimeneti puffert.

A minta futtatása után megnyithatja a fájlt a TestFile.txt kimenet megtekintéséhez.

public class Sample
{

public static int Main(string[] args) {
    // Create a file for output named TestFile.txt.
    Stream myFile = File.Create("TestFile.txt");

    /* Create a new text writer using the output stream, and add it to
     * the trace listeners. */
    TextWriterTraceListener myTextListener = new
       TextWriterTraceListener(myFile);
    Trace.Listeners.Add(myTextListener);

    // Write output to the file.
    Trace.Write("Test output ");

    // Flush the output.
    Trace.Flush();

    return 0;
 }
}

Public Class Sample
    
    Public Shared Sub Main()
        ' Create a file for output named TestFile.txt.
        Dim myFile As Stream = File.Create("TestFile.txt")
        
        ' Create a new text writer using the output stream, and add it to
        ' the trace listeners. 
        Dim myTextListener As New TextWriterTraceListener(myFile)
        Trace.Listeners.Add(myTextListener)

        
        ' Write output to the file.
        Trace.Write("Test output ")
        
        ' Flush the output.
        Trace.Flush() 

        System.Environment.ExitCode = 0
    End Sub

End Class

Megjegyzések

Az TextWriterTraceListener osztály biztosítja a tulajdonságot a Writer nyomkövetési vagy hibakeresési kimenetet fogadó szövegíró lekéréséhez vagy beállításához.

Important

Ez a típus implementálja a IDisposable felületet. Ha befejezte a típus használatát, közvetlenül (a metódus meghívásával) vagy közvetetten (például using a C#-ban) kell kezelnie Dispose a típust. További információ: Az IDisposable-t megvalósító objektum használata.

Ez az osztály metódusokat is biztosít annak érdekében Close , hogy a továbbiakban ne kapja meg a Writer nyomkövetési vagy hibakeresési kimenetet, Flush a kimeneti puffert a Writer, valamint Write a Writercímzettnek szóló üzenetet.

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.

Ha nyomkövetési figyelőt szeretne hozzáadni egy .NET-keretrendszeralkalmazáshoz, 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>

Note

Ha olyan fájlba próbálnak írni, amely használatban van vagy nem érhető el, a rendszer automatikusan előtagot ad egy GUID-azonosítónak.

Konstruktorok

Name	Description
TextWriterTraceListener()	Inicializálja az TextWriterTraceListener osztály TextWriter új példányát kimeneti címzettként.
TextWriterTraceListener(Stream, String)	Inicializálja az TextWriterTraceListener osztály új példányát a megadott névvel, és a streamet használja a hibakeresési és nyomkövetési kimenet címzettjeként.
TextWriterTraceListener(Stream)	Inicializálja az TextWriterTraceListener osztály új példányát a hibakeresési és nyomkövetési kimenet címzettjeként a stream használatával.
TextWriterTraceListener(String, String)	Inicializálja az TextWriterTraceListener osztály új példányát a megadott névvel, és a fájlt használja a hibakeresési és nyomkövetési kimenet címzettjeként.
TextWriterTraceListener(String)	Inicializálja az TextWriterTraceListener osztály új példányát a hibakeresési és nyomkövetési kimenet címzettjeként a fájl használatával.
TextWriterTraceListener(TextWriter, String)	Inicializálja az TextWriterTraceListener osztály új példányát a megadott névvel, és a megadott írót használja a nyomkövetési vagy hibakeresési kimenet címzettjeként.
TextWriterTraceListener(TextWriter)	Inicializálja az osztály új példányát a TextWriterTraceListener megadott íróval a nyomkövetési vagy hibakeresési kimenet címzettjeként.

Tulajdonságok

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

Metódusok

Name	Description
Close()	Bezárja a Writer kimenetet, 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. (Öröklődés forrása TraceListener)
Dispose(Boolean)	Az objektumot megsemmisíti TextWriterTraceListener .
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. (Öröklődés forrása TraceListener)
Fail(String)	Hibaüzenetet küld az osztály megvalósításakor létrehozott figyelőnek TraceListener . (Öröklődés forrása TraceListener)
Flush()	Kiüríti a kimeneti puffert a Writer.
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. (Öröklődés forrása TraceListener)
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. (Öröklődés forrása TraceListener)
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. (Öröklődés forrása TraceListener)
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. (Öröklődés forrása TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Nyomkövetési információkat, üzenetet és eseményadatokat ír a figyelő adott kimenetére. (Öröklődés forrása TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Nyomkövetési és eseményinformációkat ír a figyelő adott kimenetére. (Öröklődés forrása TraceListener)
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. (Öröklődés forrása TraceListener)
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. (Öröklődés forrása TraceListener)
Write(Object)	Az objektum ToString() metódusának értékét az osztály megvalósításakor TraceListener létrehozott figyelőnek írja. (Öröklődés forrása TraceListener)
Write(String, String)	Kategórianevet és üzenetet ír az osztály megvalósításakor TraceListener létrehozott figyelőnek. (Öröklődés forrása TraceListener)
Write(String)	Üzenetet ír a példánynak Writer.
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. (Öröklődés forrása TraceListener)
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. (Öröklődés forrása TraceListener)
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. (Öröklődés forrása TraceListener)
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. (Öröklődés forrása TraceListener)
WriteLine(String)	Üzenetet ír a példánynak Writer , amelyet egy sor terminátor követ. Az alapértelmezett vonal-terminátor egy kocsivisszaadás, amelyet egy sorbetöltés (\r\n) követ.

Lásd még

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• Stream
• TextWriter
• Debug
• Trace