Debug.Close Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
De uitvoerbuffer leegmaken en vervolgens de Close methode aanroepen op elk van de Listeners.
public:
static void Close();[System.Diagnostics.Conditional("DEBUG")]
public static void Close();[<System.Diagnostics.Conditional("DEBUG")>]
static member Close : unit -> unitPublic Shared Sub Close ()- Kenmerken
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 stroom en de tekstschrijver gemaakt, één regel tekst naar het bestand geschreven en vervolgens de uitvoer leeggemaakt en gesloten.
// Specify /d:DEBUG when compiling.
using System;
using System.IO;
using System.Diagnostics;
class Test
{
static void Main()
{
// Create a new stream object for an output file named TestFile.txt.
using (FileStream myFileStream =
new FileStream("TestFile.txt", FileMode.Append))
{
// Add the stream object to the trace listeners.
TextWriterTraceListener myTextListener =
new TextWriterTraceListener(myFileStream);
Debug.Listeners.Add(myTextListener);
// Write output to the file.
Debug.WriteLine("Test output");
// Flush and close the output stream.
Debug.Flush();
Debug.Close();
}
}
}
' Specify /d:DEBUG=True when compiling.
Imports System.IO
Imports System.Diagnostics
Class Test
Shared Sub Main()
' Create a new stream object for an output file named TestFile.txt.
Using myFileStream As New FileStream("TestFile.txt", FileMode.Append)
' Add the stream object to the trace listeners.
Dim myTextListener As New TextWriterTraceListener(myFileStream)
Debug.Listeners.Add(myTextListener)
' Write output to the file.
Debug.WriteLine("Test output")
' Flush and close the output stream.
Debug.Flush()
Debug.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.