Trace.Close Methode

Definitie

Naamruimte:
System.Diagnostics
Assembly:
System.dll
Assembly:
netstandard.dll

Hiermee wordt de uitvoerbuffer leeggemaakt en vervolgens de Listeners.

public:
 static void Close();
[System.Diagnostics.Conditional("TRACE")]
public static void Close();
[<System.Diagnostics.Conditional("TRACE")>]
static member Close : unit -> unit
Public Shared Sub Close ()
Kenmerken
ConditionalAttribute

Voorbeelden

In het volgende voorbeeld wordt een TextWriterTraceListener benoemde naam gemaakt myTextListener. myTextListener maakt gebruik van een StreamWriter aangeroepen myOutputWriter om te schrijven naar een bestand met de naam TestFile.txt. In het voorbeeld wordt het bestand, de stream en de tekstschrijver gemaakt, één regel tekst naar het bestand geschreven en vervolgens de uitvoer leeggemaakt en gesloten.

// Specify /d:TRACE when compiling.

using System;
using System.IO;
using System.Diagnostics;

class Test
{
    static void Main()
    {
        // Create a file for output named TestFile.txt.
        using (FileStream myFileStream =
            new FileStream("TestFile.txt", FileMode.Append))
        {
            // Create a new text writer using the output stream
            // and add it to the trace listeners.
            TextWriterTraceListener myTextListener =
                new TextWriterTraceListener(myFileStream);
            Trace.Listeners.Add(myTextListener);

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

            // Flush and close the output stream.
            Trace.Flush();
            Trace.Close();
        }
    }
}

' Specify /d:TRACE=True when compiling.

Imports System.IO
Imports System.Diagnostics

Class Test
    
    Shared Sub Main()
    
        ' Create a file for output named TestFile.txt.
        Using myFileStream As New FileStream("TestFile.txt", FileMode.Append)
        
            ' Create a new text writer using the output stream
            ' and add it to the trace listeners. 
            Dim myTextListener As New TextWriterTraceListener(myFileStream)
            Trace.Listeners.Add(myTextListener)
            
            ' Write output to the file.
            Trace.WriteLine("Test output")
            
            ' Flush and close the output stream.
            Trace.Flush()
            Trace.Close()
        
        End Using
        
    End Sub

End Class

Opmerkingen

Gebruik deze methode wanneer de uitvoer naar een bestand gaat, zoals naar de TextWriterTraceListener.

Als u de stream leeg maakt, wordt de onderliggende encoder niet leeggemaakt, tenzij u expliciet aanroept Flush of Close. Dit betekent AutoFlushtrue dat gegevens van de buffer naar de stream worden leeggemaakt, maar dat de encoderstatus niet wordt leeggemaakt. Hierdoor kan de encoder de status (gedeeltelijke tekens) behouden, zodat het volgende blok tekens correct kan coderen. Dit scenario is van invloed op UTF8 en UTF7, waarbij bepaalde tekens alleen kunnen worden gecodeerd nadat de encoder het aangrenzende teken of de aangrenzende tekens heeft ontvangen.

Van toepassing op

Zie ook