Partilhar via


TextWriterTraceListener Construtores

Definição

Inicializa uma nova instância da classe TextWriterTraceListener.

Sobrecargas

TextWriterTraceListener()

Inicializa uma nova instância da classe TextWriterTraceListener com TextWriter como o destinatário de saída.

TextWriterTraceListener(Stream)

Inicializa uma nova instância da classe TextWriterTraceListener, usando o fluxo como o destinatário da saída de depuração e de rastreamento.

TextWriterTraceListener(TextWriter)

Inicializa uma nova instância da classe TextWriterTraceListener, usando o gravador especificado como destino da saída de depuração ou rastreamento.

TextWriterTraceListener(String)

Inicializa uma nova instância da classe TextWriterTraceListener usando o arquivo como destinatário da saída da depuração e do rastreamento.

TextWriterTraceListener(Stream, String)

Inicializa uma nova instância da classe TextWriterTraceListener com o nome especificado, usando o fluxo como o destinatário da saída de depuração e rastreamento.

TextWriterTraceListener(TextWriter, String)

Inicializa uma nova instância da classe TextWriterTraceListener com o nome especificado, usando o gravador especificado como o destinatário da saída de rastreamento ou depuração.

TextWriterTraceListener(String, String)

Inicializa uma nova instância da classe TextWriterTraceListener com o nome especificado, usando o arquivo como o destinatário da saída de depuração e de rastreamento.

TextWriterTraceListener()

Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs

Inicializa uma nova instância da classe TextWriterTraceListener com TextWriter como o destinatário de saída.

public:
 TextWriterTraceListener();
public TextWriterTraceListener ();
Public Sub New ()

Exemplos

O exemplo a seguir cria um TextWriterTraceListener usando o TextWriterTraceListener() construtor . Ele define a Writer propriedade como saída do console e, em seguida, adiciona o TextWriterTraceListener ao TraceListenerCollection. Ele grava uma mensagem em dois segmentos e fecha o TextWriterTraceListener.

void main()
{
   #if defined(TRACE)
   // Create a text writer that writes to the console screen and add
   // it to the trace listeners.
   TextWriterTraceListener^ myWriter = gcnew TextWriterTraceListener;
   myWriter->Writer = System::Console::Out;
   Trace::Listeners->Add( myWriter );
   
   // Write the output to the console screen.
   myWriter->Write( "Write to the Console screen. " );
   myWriter->WriteLine( "Again, write to console screen." );
   
   // Flush and close the output.
   myWriter->Flush();
   myWriter->Close();
   #endif
}
public class Sample
{
    public static void Main(string[] args)
    {
        /* Create a text writer that writes to the console screen and add
         * it to the trace listeners */
        TextWriterTraceListener myWriter = new TextWriterTraceListener();
        myWriter.Writer = System.Console.Out;
        Trace.Listeners.Add(myWriter);

        // Write the output to the console screen.
        myWriter.Write("Write to the Console screen. ");
        myWriter.WriteLine("Again, write to console screen.");

        // Flush and close the output.
        myWriter.Flush();
        myWriter.Close();
    }
}
Public Class Sample
    
    Public Shared Sub Main()
        ' Create a text writer that writes to the console screen and add
        ' it to the trace listeners 
        Dim myWriter As New TextWriterTraceListener()
        myWriter.Writer = System.Console.Out
        Trace.Listeners.Add(myWriter)
        
        ' Write the output to the console screen.
        myWriter.Write("Write to the Console screen. ")
        myWriter.WriteLine("Again, write to console screen.")
        
        ' Flush and close the output.
        myWriter.Flush()
        myWriter.Close()
    End Sub

End Class

Comentários

Esse construtor usa o TextWriter fluxo como o destinatário da saída de rastreamento ou depuração. Sua Name propriedade é inicializada para uma cadeia de caracteres vazia ("", ou String.Empty).

Confira também

Aplica-se a

TextWriterTraceListener(Stream)

Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs

Inicializa uma nova instância da classe TextWriterTraceListener, usando o fluxo como o destinatário da saída de depuração e de rastreamento.

public:
 TextWriterTraceListener(System::IO::Stream ^ stream);
public TextWriterTraceListener (System.IO.Stream stream);
new System.Diagnostics.TextWriterTraceListener : System.IO.Stream -> System.Diagnostics.TextWriterTraceListener
Public Sub New (stream As Stream)

Parâmetros

stream
Stream

Um Stream que representa o fluxo no qual o TextWriterTraceListener é gravado.

Exceções

O fluxo é null.

Exemplos

O exemplo de código a seguir cria um TextWriterTraceListener usando o TextWriterTraceListener(Stream) construtor e o adiciona ao TraceListenerCollection. Em seguida, o exemplo grava duas mensagens nesse TextWriterTraceListenere grava uma mensagem em todos os TraceListener objetos no TraceListenerCollection. Por fim, ele libera e fecha o TextWriterTraceListener.

using System;
using System.Diagnostics;
using System.IO;
using Microsoft.VisualBasic;

class TWTLConStreamMod
{

    // args(0) is the specification of the trace log file.
    public static void Main(string[] args)
    {

        // Verify that a parameter was entered.
        if (args.Length==0)
        {
            Console.WriteLine("Enter a trace file specification.");
        }
        else
        {
            // Create a stream object.
            FileStream traceStream;
            try
            {
                traceStream = new FileStream(args[0], FileMode.Append, FileAccess.Write);
            }
            catch(Exception ex)
            {
                Console.WriteLine("Error creating FileStream for trace file \"{0}\":" +
                    "\r\n{1}", args[0], ex.Message);
                return;
            }

            // Create a TextWriterTraceListener object that takes a stream.
            TextWriterTraceListener textListener;
            textListener = new TextWriterTraceListener(traceStream);
            Trace.Listeners.Add(textListener);

            // Write these messages only to this TextWriterTraceListener.
            textListener.WriteLine("This is trace listener named \""+ textListener.Name+"\"");
            textListener.WriteLine("Trace written through a stream to: " +
                "\r\n    \""+args[0]+"\"");

            // Write a message to all trace listeners.
            Trace.WriteLine(String.Format("This trace message written {0} to all listeners.", DateTime.Now));

            // Flush and close the output.
            Trace.Flush();
            textListener.Flush();
            textListener.Close();
        }
    }
}
Imports System.Diagnostics
Imports System.IO

Module TWTLConStreamMod

    ' args(0) is the specification of the trace log file.
    Sub Main(ByVal args() As String)

        ' Verify that a parameter was entered.
        If args.Length = 0 Then
            Console.WriteLine("Enter a trace file specification.")

        Else
            ' Create a stream object.
            Dim traceStream As FileStream
            Try
                traceStream = New FileStream( _
                    args(0), FileMode.Append, FileAccess.Write)
            Catch ex As Exception
                Console.WriteLine( _
                    "Error creating FileStream for trace file ""{0}"":" & _
                    vbCrLf & "{1}", args(0), ex.Message)
                Return
            End Try

            ' Create a TextWriterTraceListener object that takes a stream.
            Dim textListener As TextWriterTraceListener
            textListener = New TextWriterTraceListener(traceStream)
            Trace.Listeners.Add(textListener)

            ' Write these messages only to this TextWriterTraceListener.
            textListener.WriteLine( _
                "This is trace listener named """ & textListener.Name & """")
            textListener.WriteLine( _
                "Trace written through a stream to: " & _
                vbCrLf & "    """ & args(0) & """")

            ' Write a message to all trace listeners.
            Trace.WriteLine(String.Format( _
                "This trace message written {0} to all listeners.", Now))

            ' Flush and close the output.
            Trace.Flush()
            textListener.Flush()
            textListener.Close()
        End If
    End Sub
End Module

Comentários

Esse construtor inicializa a Name propriedade para uma cadeia de caracteres vazia ("").

Confira também

Aplica-se a

TextWriterTraceListener(TextWriter)

Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs

Inicializa uma nova instância da classe TextWriterTraceListener, usando o gravador especificado como destino da saída de depuração ou rastreamento.

public:
 TextWriterTraceListener(System::IO::TextWriter ^ writer);
public TextWriterTraceListener (System.IO.TextWriter writer);
new System.Diagnostics.TextWriterTraceListener : System.IO.TextWriter -> System.Diagnostics.TextWriterTraceListener
Public Sub New (writer As TextWriter)

Parâmetros

writer
TextWriter

Um TextWriter que recebe a saída do TextWriterTraceListener.

Exceções

O gravador está null.

Exemplos

O exemplo de código a seguir cria um TextWriterTraceListener usando o TextWriterTraceListener(TextWriter) construtor . O exemplo cria um StreamWriter, em seguida, faz referência ao StreamWriter quando cria o TextWriterTraceListener, que, em seguida, adiciona ao TraceListenerCollection. O exemplo grava uma mensagem em todos os TraceListener objetos no TraceListenerCollectione fecha este TextWriterTraceListener.

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

void main()
{
   #if defined(TRACE)
   TextWriterTraceListener^ myTextListener = nullptr;
   
   // Create a file for output named TestFile.txt.
   String^ myFileName = "TestFile.txt";
   StreamWriter^ myOutputWriter = gcnew StreamWriter( myFileName,true );
   
   // Add a TextWriterTraceListener for the file.
   if ( myOutputWriter )
   {
      myTextListener = gcnew TextWriterTraceListener( myOutputWriter );
      Trace::Listeners->Add( myTextListener );
   }

   // Write trace output to all trace listeners.
   Trace::WriteLine( 
      String::Concat( DateTime::Now.ToString(), " - Trace output" ) );
   if ( myTextListener )
   {
      // Remove and close the file writer/trace listener.
      myTextListener->Flush();
      Trace::Listeners->Remove( myTextListener );
      myTextListener->Close();
   }
   #endif
}
#define TRACE

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

public class TextWriterTraceListenerSample
{
    public static void Main()
    {
        TextWriterTraceListener myTextListener = null;

        // Create a file for output named TestFile.txt.
        string myFileName = "TestFile.txt";
        StreamWriter myOutputWriter = new StreamWriter(myFileName, true);

        // Add a TextWriterTraceListener for the file.
        myTextListener = new TextWriterTraceListener(myOutputWriter);
        Trace.Listeners.Add(myTextListener);

        // Write trace output to all trace listeners.
        Trace.WriteLine(DateTime.Now.ToString() + " - Trace output");

        // Remove and close the file writer/trace listener.
        myTextListener.Flush();
        Trace.Listeners.Remove(myTextListener);
        myTextListener.Close();
    }
}
#Const TRACE=True

Imports System.IO
Imports System.Diagnostics

Public Class TextWriterTraceListenerSample
   
   Public Shared Sub Main()
      Dim myTextListener As TextWriterTraceListener = Nothing

      ' Create a file for output named TestFile.txt.
      Dim myFileName As String = "TestFile.txt"
      Dim myOutputWriter As New StreamWriter(myFileName, True)
 
      ' Add a TextWriterTraceListener for the file.
      myTextListener = New TextWriterTraceListener(myOutputWriter)
      Trace.Listeners.Add(myTextListener)
     
      ' Write trace output to all trace listeners.
      Trace.WriteLine(DateTime.Now.ToString() + " - Trace output")
      
      ' Remove and close the file writer/trace listener.
      myTextListener.Flush()
      Trace.Listeners.Remove(myTextListener)
      myTextListener.Close()

   End Sub
End Class

Comentários

Esse construtor inicializa a Name propriedade para uma cadeia de caracteres vazia ("").

Confira também

Aplica-se a

TextWriterTraceListener(String)

Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs

Inicializa uma nova instância da classe TextWriterTraceListener usando o arquivo como destinatário da saída da depuração e do rastreamento.

public:
 TextWriterTraceListener(System::String ^ fileName);
public TextWriterTraceListener (string? fileName);
public TextWriterTraceListener (string fileName);
new System.Diagnostics.TextWriterTraceListener : string -> System.Diagnostics.TextWriterTraceListener
Public Sub New (fileName As String)

Parâmetros

fileName
String

O nome do arquivo no qual o TextWriterTraceListener é gravado.

Exceções

O arquivo é null.

Exemplos

O exemplo de código a seguir cria um TextWriterTraceListener usando o TextWriterTraceListener(String) construtor e o adiciona ao TraceListenerCollection. O exemplo grava duas mensagens nesse TextWriterTraceListenere grava uma mensagem em todos os TraceListener objetos no TraceListenerCollection. Por fim, ele libera e fecha o TextWriterTraceListener.

using System;
using System.Diagnostics;
using Microsoft.VisualBasic;

class TWTLConStringMod
{

    // args(0) is the specification of the trace log file.
    public static void Main(string[] args)
    {

        // Verify that a parameter was entered.
        if (args.Length==0)
        {
            Console.WriteLine("Enter a trace file specification.");
        }
        else
        {
            // Create a TextWriterTraceListener object that takes a
            // file specification.
            TextWriterTraceListener textListener;
            try
            {
                textListener = new TextWriterTraceListener(args[0]);
                Trace.Listeners.Add(textListener);
            }
            catch(Exception ex)
            {
                Console.WriteLine("Error creating TextWriterTraceListener for trace " +
                    "file \"{0}\":\r\n{1}", args[0], ex.Message);
                return;
            }

            // Write these messages only to the TextWriterTraceListener.
            textListener.WriteLine("This is trace listener named \""+textListener.Name+"\"");
            textListener.WriteLine("Trace written to a file: " +
                "\r\n    \""+args[0]+"\"");

            // Write a message to all trace listeners.
            Trace.WriteLine(String.Format("This trace message written {0} to all listeners.", DateTime.Now));

            // Flush and close the output.
            Trace.Flush();
            textListener.Flush();
            textListener.Close();
        }
    }
}
Imports System.Diagnostics

Module TWTLConStringMod

    ' args(0) is the specification of the trace log file.
    Sub Main(ByVal args() As String)

        ' Verify that a parameter was entered.
        If args.Length = 0 Then
            Console.WriteLine("Enter a trace file specification.")

        Else
            ' Create a TextWriterTraceListener object that takes a 
            ' file specification.
            Dim textListener As TextWriterTraceListener
            Try
                textListener = New TextWriterTraceListener(args(0))
                Trace.Listeners.Add(textListener)
            Catch ex As Exception
                Console.WriteLine( _
                    "Error creating TextWriterTraceListener for trace " & _
                    "file ""{0}"":" & vbCrLf & "{1}", args(0), ex.Message)
                Return
            End Try

            ' Write these messages only to the TextWriterTraceListener.
            textListener.WriteLine( _
                "This is trace listener named """ & textListener.Name & """")
            textListener.WriteLine("Trace written to a file: " & _
                vbCrLf & "    """ & args(0) & """")

            ' Write a message to all trace listeners.
            Trace.WriteLine(String.Format( _
                "This trace message written {0} to all listeners.", Now))

            ' Flush and close the output.
            Trace.Flush()
            textListener.Flush()
            textListener.Close()
        End If
    End Sub
End Module

Comentários

Esse construtor inicializa a Name propriedade para uma cadeia de caracteres vazia ("").

Confira também

Aplica-se a

TextWriterTraceListener(Stream, String)

Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs

Inicializa uma nova instância da classe TextWriterTraceListener com o nome especificado, usando o fluxo como o destinatário da saída de depuração e rastreamento.

public:
 TextWriterTraceListener(System::IO::Stream ^ stream, System::String ^ name);
public TextWriterTraceListener (System.IO.Stream stream, string? name);
public TextWriterTraceListener (System.IO.Stream stream, string name);
new System.Diagnostics.TextWriterTraceListener : System.IO.Stream * string -> System.Diagnostics.TextWriterTraceListener
Public Sub New (stream As Stream, name As String)

Parâmetros

stream
Stream

Um Stream que representa o fluxo no qual o TextWriterTraceListener é gravado.

name
String

O nome da nova instância.

Exceções

O fluxo é null.

Exemplos

O exemplo de código a seguir cria um TextWriterTraceListener usando o TextWriterTraceListener(Stream, String) construtor e o adiciona ao TraceListenerCollection. Em seguida, o exemplo grava duas mensagens e TextWriterTraceListener grava uma mensagem em todos os TraceListener objetos no TraceListenerCollection. Por fim, ele libera e fecha o TextWriterTraceListener.

using System;
using System.Diagnostics;
using System.IO;
using Microsoft.VisualBasic;

class TWTLConStreamNameMod
{

    const string LISTENER_NAME = "myStreamListener";

    // args(0) is the specification of the trace log file.
    public static void Main(string[] args)
    {

        // Verify that a parameter was entered.
        if (args.Length==0)
        {
            Console.WriteLine("Enter a trace file specification.");
        }
        else
        {
            // Create a stream object.
            FileStream traceStream;
            try
            {
                traceStream = new FileStream(args[0], FileMode.Append, FileAccess.Write);
            }
            catch(Exception ex)
            {
                Console.WriteLine("Error creating FileStream for trace file \"{0}\":" +
                    "\r\n{1}", args[0], ex.Message);
                return;
            }

            // Create a TextWriterTraceListener object that takes a stream.
            TextWriterTraceListener textListener;
            textListener = new TextWriterTraceListener(traceStream, LISTENER_NAME);
            Trace.Listeners.Add(textListener);

            // Write these messages only to the TextWriterTraceListener.
            textListener.WriteLine("This is trace listener named \""+textListener.Name+"\"");
            textListener.WriteLine("Trace written through a stream to: " +
                "\r\n    \""+args[0]+"\"");

            // Write a message to all trace listeners.
            Trace.WriteLine(String.Format("This trace message written {0} to all listeners.", DateTime.Now));

            // Flush and close the output.
            Trace.Flush();
            textListener.Flush();
            textListener.Close();
        }
    }
}
Imports System.Diagnostics
Imports System.IO

Module TWTLConStreamNameMod

    Const LISTENER_NAME As String = "myStreamListener"

    ' args(0) is the specification of the trace log file.
    Sub Main(ByVal args() As String)

        ' Verify that a parameter was entered.
        If args.Length = 0 Then
            Console.WriteLine("Enter a trace file specification.")

        Else
            ' Create a stream object.
            Dim traceStream As FileStream
            Try
                traceStream = New FileStream( _
                    args(0), FileMode.Append, FileAccess.Write)
            Catch ex As Exception
                Console.WriteLine( _
                    "Error creating FileStream for trace file ""{0}"":" & _
                    vbCrLf & "{1}", args(0), ex.Message)
                Return
            End Try

            ' Create a TextWriterTraceListener object that takes a stream.
            Dim textListener As TextWriterTraceListener
            textListener = _
                New TextWriterTraceListener(traceStream, LISTENER_NAME)
            Trace.Listeners.Add(textListener)

            ' Write these messages only to the TextWriterTraceListener.
            textListener.WriteLine( _
                "This is trace listener named """ & textListener.Name & """")
            textListener.WriteLine( _
                "Trace written through a stream to: " & _
                vbCrLf & "    """ & args(0) & """")

            ' Write a message to all trace listeners.
            Trace.WriteLine(String.Format( _
                "This trace message written {0} to all listeners.", Now))

            ' Flush and close the output.
            Trace.Flush()
            textListener.Flush()
            textListener.Close()
        End If
    End Sub
End Module

Comentários

Esse construtor inicializa a Name propriedade para o name parâmetro ou para uma cadeia de caracteres vazia (""), se o name parâmetro for null.

Confira também

Aplica-se a

TextWriterTraceListener(TextWriter, String)

Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs

Inicializa uma nova instância da classe TextWriterTraceListener com o nome especificado, usando o gravador especificado como o destinatário da saída de rastreamento ou depuração.

public:
 TextWriterTraceListener(System::IO::TextWriter ^ writer, System::String ^ name);
public TextWriterTraceListener (System.IO.TextWriter writer, string? name);
public TextWriterTraceListener (System.IO.TextWriter writer, string name);
new System.Diagnostics.TextWriterTraceListener : System.IO.TextWriter * string -> System.Diagnostics.TextWriterTraceListener
Public Sub New (writer As TextWriter, name As String)

Parâmetros

writer
TextWriter

Um TextWriter que recebe a saída do TextWriterTraceListener.

name
String

O nome da nova instância.

Exceções

O gravador está null.

Exemplos

O exemplo de código a seguir cria um TextWriterTraceListener usando o TextWriterTraceListener(TextWriter, String) construtor . O exemplo cria um StreamWriter, em seguida, faz referência ao StreamWriter quando cria o TextWriterTraceListener, que, em seguida, adiciona ao TraceListenerCollection. O exemplo grava duas mensagens nesse TextWriterTraceListenere grava uma mensagem em todos os TraceListener objetos no TraceListenerCollection. Por fim, ele libera e fecha o TextWriterTraceListener.

using System;
using System.Diagnostics;
using System.IO;
using Microsoft.VisualBasic;

class TWTLConWriterNameMod
{

    const string LISTENER_NAME = "myWriterListener";

    // args(0) is the specification of the trace log file.
    public static void Main(string[] args)
    {

        // Verify that a parameter was entered.
        if (args.Length==0)
        {
            Console.WriteLine("Enter a trace file specification.");
        }
        else
        {
            // Create a StreamWriter object that supports appending.
            StreamWriter traceWriter;
            try
            {
                traceWriter = new StreamWriter(args[0], true);
            }
            catch(Exception ex)
            {
                Console.WriteLine("Error creating StreamWriter for trace file \"{0}\":" +
                    "\r\n{1}", args[0], ex.Message);
                return;
            }

            // Create a TextWriterTraceListener that takes a StreamWriter.
            TextWriterTraceListener textListener;
            textListener = new TextWriterTraceListener(traceWriter, LISTENER_NAME);
            Trace.Listeners.Add(textListener);

            // Write these messages only to this TextWriterTraceListener.
            textListener.WriteLine("This is trace listener named \""+textListener.Name+"\"");
            textListener.WriteLine("Trace written through a stream to: " +
                "\r\n    \""+args[0]+"\"");

            // Write a message to all trace listeners.
            Trace.WriteLine(String.Format("This trace message written {0} to all listeners.", DateTime.Now));

            // Flush and close the output.
            Trace.Flush();
            textListener.Flush();
            textListener.Close();
        }
    }
}
Imports System.Diagnostics
Imports System.IO

Module TWTLConWriterNameMod

    Const LISTENER_NAME As String = "myWriterListener"

    ' args(0) is the specification of the trace log file.
    Sub Main(ByVal args() As String)

        ' Verify that a parameter was entered.
        If args.Length = 0 Then
            Console.WriteLine("Enter a trace file specification.")

        Else
            ' Create a StreamWriter object that supports appending.
            Dim traceWriter As StreamWriter
            Try
                traceWriter = New StreamWriter(args(0), True)
            Catch ex As Exception
                Console.WriteLine( _
                    "Error creating StreamWriter for trace file ""{0}"":" & _
                    vbCrLf & "{1}", args(0), ex.Message)
                Return
            End Try

            ' Create a TextWriterTraceListener that takes a StreamWriter.
            Dim textListener As TextWriterTraceListener
            textListener = _
                New TextWriterTraceListener(traceWriter, LISTENER_NAME)
            Trace.Listeners.Add(textListener)

            ' Write these messages only to this TextWriterTraceListener.
            textListener.WriteLine( _
                "This is trace listener named """ & textListener.Name & """")
            textListener.WriteLine( _
                "Trace written through a stream to: " & _
                vbCrLf & "    """ & args(0) & """")

            ' Write a message to all trace listeners.
            Trace.WriteLine(String.Format( _
                "This trace message written {0} to all listeners.", Now))

            ' Flush and close the output.
            Trace.Flush()
            textListener.Flush()
            textListener.Close()
        End If
    End Sub
End Module

Confira também

Aplica-se a

TextWriterTraceListener(String, String)

Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs
Origem:
TextWriterTraceListener.cs

Inicializa uma nova instância da classe TextWriterTraceListener com o nome especificado, usando o arquivo como o destinatário da saída de depuração e de rastreamento.

public:
 TextWriterTraceListener(System::String ^ fileName, System::String ^ name);
public TextWriterTraceListener (string? fileName, string? name);
public TextWriterTraceListener (string fileName, string name);
new System.Diagnostics.TextWriterTraceListener : string * string -> System.Diagnostics.TextWriterTraceListener
Public Sub New (fileName As String, name As String)

Parâmetros

fileName
String

O nome do arquivo no qual o TextWriterTraceListener é gravado.

name
String

O nome da nova instância.

Exceções

O fluxo é null.

Exemplos

O exemplo de código a seguir cria um TextWriterTraceListener usando o TextWriterTraceListener(String, String) construtor e o adiciona ao TraceListenerCollection. O exemplo grava duas mensagens nesse TextWriterTraceListenere grava uma mensagem em todos os TraceListener objetos no TraceListenerCollection. Por fim, ele libera e fecha o TextWriterTraceListener.

using System;
using System.Diagnostics;
using Microsoft.VisualBasic;

class TWTLConStringNameMod
{

    const string LISTENER_NAME = "myStringListener";

    // args(0) is the specification of the trace log file.
    public static void Main(string[] args)
    {

        // Verify that a parameter was entered.
        if (args.Length==0)
        {
            Console.WriteLine("Enter a trace file specification.");
        }
        else
        {
            // Create a TextWriterTraceListener object that takes a
            // file specification.
            TextWriterTraceListener textListener;
            try
            {
                textListener = new TextWriterTraceListener(args[0], LISTENER_NAME);
                Trace.Listeners.Add(textListener);
            }
            catch(Exception ex)
            {
                Console.WriteLine("Error creating TextWriterTraceListener for trace " +
                    "file \"{0}\":\r\n{1}", args[0], ex.Message);
                return;
            }

            // Write these messages only to this TextWriterTraceListener.
            textListener.WriteLine("This is trace listener named \""+textListener.Name+"\"");
            textListener.WriteLine("Trace written to a file: " +
                "\r\n    \""+args[0]+"\"");

            // Write a message to all trace listeners.
            Trace.WriteLine(String.Format("This trace message written {0} to all listeners.", DateTime.Now));

            // Flush and close the output.
            Trace.Flush();
            textListener.Flush();
            textListener.Close();
        }
    }
}
Imports System.Diagnostics

Module TWTLConStringNameMod

    Const LISTENER_NAME As String = "myStringListener"

    ' args(0) is the specification of the trace log file.
    Sub Main(ByVal args() As String)

        ' Verify that a parameter was entered.
        If args.Length = 0 Then
            Console.WriteLine("Enter a trace file specification.")

        Else
            ' Create a TextWriterTraceListener object that takes a 
            ' file specification.
            Dim textListener As TextWriterTraceListener
            Try
                textListener = _
                    New TextWriterTraceListener(args(0), LISTENER_NAME)
                Trace.Listeners.Add(textListener)
            Catch ex As Exception
                Console.WriteLine( _
                    "Error creating TextWriterTraceListener for trace " & _
                    "file ""{0}"":" & vbCrLf & "{1}", args(0), ex.Message)
                Return
            End Try

            ' Write these messages only to this TextWriterTraceListener.
            textListener.WriteLine( _
                "This is trace listener named """ & textListener.Name & """")
            textListener.WriteLine("Trace written to a file: " & _
                vbCrLf & "    """ & args(0) & """")

            ' Write a message to all trace listeners.
            Trace.WriteLine(String.Format( _
                "This trace message written {0} to all listeners.", Now))

            ' Flush and close the output.
            Trace.Flush()
            textListener.Flush()
            textListener.Close()
        End If
    End Sub
End Module

Comentários

Esse construtor inicializa a Name propriedade para o name parâmetro ou para uma cadeia de caracteres vazia (""), se o name parâmetro for null.

Confira também

Aplica-se a