Debug.Close Méthode

Définition

Vide la mémoire tampon de sortie, puis appelle la méthode Close sur chaque Listeners.

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

Exemples

L’exemple suivant crée un TextWriterTraceListener nom myTextListener. myTextListener utilise un StreamWriter appelé myOutputWriter pour écrire dans un fichier nommé TestFile.txt. L’exemple crée le fichier, le flux et l’enregistreur de texte, écrit une ligne de texte dans le fichier, puis vide et ferme la sortie.

// Specify /DDEBUG when compiling.

#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Diagnostics;

void main()
{
     #if defined(DEBUG)
    // Create a new stream object for an output file named TestFile.txt.
    FileStream^ myFileStream = 
        gcnew FileStream( "TestFile.txt", FileMode::Append );
   
    // Add the stream object to the trace listeners.
    TextWriterTraceListener^ myTextListener = 
        gcnew 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();
    #endif
}
// 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

Remarques

Utilisez cette méthode lorsque la sortie est envoyée à un fichier, par exemple dans le TextWriterTraceListenerfichier .

Le vidage du flux ne vide pas son encodeur sous-jacent, sauf si vous appelez Flush explicitement ou Close. Paramètre AutoFlush pour true indiquer que les données seront vidées de la mémoire tampon vers le flux, mais l’état de l’encodeur ne sera pas vidé. Cela permet à l’encodeur de conserver son état (caractères partiels) afin qu’il puisse encoder correctement le bloc de caractères suivant. Ce scénario affecte UTF8 et UTF7 où certains caractères ne peuvent être codés qu’après que l’encodeur reçoit le caractère ou les caractères adjacents.

S’applique à

Voir aussi