TextWriterTraceListener Конструкторы

Определение

Инициализирует новый экземпляр класса TextWriterTraceListener.

Перегрузки

TextWriterTraceListener()

Инициализирует новый экземпляр класса TextWriterTraceListener с помощью TextWriter в качестве выходного получателя.

TextWriterTraceListener(Stream)

Инициализирует новый экземпляр класса TextWriterTraceListener, используя этот поток в качестве получателя выходных данных отладки и трассировки.

TextWriterTraceListener(TextWriter)

Инициализирует новый экземпляр класса TextWriterTraceListener, используя заданное средство записи в качестве получателя выходных данных отладки или трассировки.

TextWriterTraceListener(String)

Инициализирует новый экземпляр класса TextWriterTraceListener, используя этот файл в качестве получателя выходных данных отладки и трассировки.

TextWriterTraceListener(Stream, String)

Инициализирует новый экземпляр класса TextWriterTraceListener с заданным именем, используя этот поток в качестве получателя выходных данных отладки и трассировки.

TextWriterTraceListener(TextWriter, String)

Инициализирует новый экземпляр класса TextWriterTraceListener с заданным именем, используя заданное средство записи в качестве получателя выходных данных отладки или трассировки.

TextWriterTraceListener(String, String)

Инициализирует новый экземпляр класса TextWriterTraceListener с заданным именем, используя этот файл в качестве получателя выходных данных отладки и трассировки.

TextWriterTraceListener()

Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs

Инициализирует новый экземпляр класса TextWriterTraceListener с помощью TextWriter в качестве выходного получателя.

public TextWriterTraceListener ();

Примеры

В следующем примере создается TextWriterTraceListener с помощью конструктора TextWriterTraceListener() . Он задает Writer для свойства выходные данные консоли, а затем добавляет в TextWriterTraceListenerTraceListenerCollection. Он записывает сообщение в два сегмента, а затем закрывает TextWriterTraceListener.

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();
    }
}

Комментарии

Этот конструктор использует поток в TextWriter качестве получателя выходных данных трассировки или отладки. Его Name свойство инициализируется пустой строкой ("" или String.Empty).

См. также раздел

Применяется к

TextWriterTraceListener(Stream)

Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs

Инициализирует новый экземпляр класса TextWriterTraceListener, используя этот поток в качестве получателя выходных данных отладки и трассировки.

public TextWriterTraceListener (System.IO.Stream stream);

Параметры

stream
Stream

Объект Stream, представляющий поток, в который записывает объект TextWriterTraceListener.

Исключения

Поток имеет значение null.

Примеры

В следующем примере кода создается TextWriterTraceListener с помощью конструктора TextWriterTraceListener(Stream) и добавляется TraceListenerCollectionв . Затем в этот пример записывается TextWriterTraceListenerдва сообщения, а для всех TraceListener объектов в TraceListenerCollection. Наконец, он очищает и закрывает 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();
        }
    }
}

Комментарии

Этот конструктор инициализирует Name свойство пустой строкой ("").

См. также раздел

Применяется к

TextWriterTraceListener(TextWriter)

Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs

Инициализирует новый экземпляр класса TextWriterTraceListener, используя заданное средство записи в качестве получателя выходных данных отладки или трассировки.

public TextWriterTraceListener (System.IO.TextWriter writer);

Параметры

writer
TextWriter

Поток TextWriter, принимающий выходные данные из объекта TextWriterTraceListener.

Исключения

Модуль записи равен null.

Примеры

В следующем примере кода создается TextWriterTraceListener с помощью конструктора TextWriterTraceListener(TextWriter) . В примере создается StreamWriter, а затем ссылается на StreamWriter при создании TextWriterTraceListener, который затем добавляется в TraceListenerCollection. В примере сообщение записывается во все TraceListener объекты в TraceListenerCollection, а затем закрывается .TextWriterTraceListener

#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();
    }
}

Комментарии

Этот конструктор инициализирует Name свойство пустой строкой ("").

См. также раздел

Применяется к

TextWriterTraceListener(String)

Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs

Инициализирует новый экземпляр класса TextWriterTraceListener, используя этот файл в качестве получателя выходных данных отладки и трассировки.

public TextWriterTraceListener (string? fileName);
public TextWriterTraceListener (string fileName);

Параметры

fileName
String

Имя файла, в который осуществляет запись объект TextWriterTraceListener.

Исключения

Файл имеет значение null.

Примеры

В следующем примере кода создается TextWriterTraceListener с помощью конструктора TextWriterTraceListener(String) , а затем добавляется в TraceListenerCollection. Пример записывает два сообщения в этот TextWriterTraceListener, а затем записывает сообщение для всех TraceListener объектов в TraceListenerCollection. Наконец, он очищает и закрывает 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();
        }
    }
}

Комментарии

Этот конструктор инициализирует Name свойство пустой строкой ("").

См. также раздел

Применяется к

TextWriterTraceListener(Stream, String)

Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs

Инициализирует новый экземпляр класса TextWriterTraceListener с заданным именем, используя этот поток в качестве получателя выходных данных отладки и трассировки.

public TextWriterTraceListener (System.IO.Stream stream, string? name);
public TextWriterTraceListener (System.IO.Stream stream, string name);

Параметры

stream
Stream

Объект Stream, представляющий поток, в который записывает объект TextWriterTraceListener.

name
String

Имя нового экземпляра.

Исключения

Поток имеет значение null.

Примеры

В следующем примере кода создается TextWriterTraceListener с помощью конструктора TextWriterTraceListener(Stream, String) и добавляется TraceListenerCollectionв . Затем в этот пример записывается TextWriterTraceListener два сообщения, а для всех TraceListener объектов в TraceListenerCollection. Наконец, он очищает и закрывает 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();
        }
    }
}

Комментарии

Этот конструктор инициализирует Name свойство параметром name или пустой строкой (""), если name параметр имеет значение null.

См. также раздел

Применяется к

TextWriterTraceListener(TextWriter, String)

Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs

Инициализирует новый экземпляр класса TextWriterTraceListener с заданным именем, используя заданное средство записи в качестве получателя выходных данных отладки или трассировки.

public TextWriterTraceListener (System.IO.TextWriter writer, string? name);
public TextWriterTraceListener (System.IO.TextWriter writer, string name);

Параметры

writer
TextWriter

Поток TextWriter, принимающий выходные данные из объекта TextWriterTraceListener.

name
String

Имя нового экземпляра.

Исключения

Модуль записи равен null.

Примеры

В следующем примере кода создается TextWriterTraceListener с помощью конструктора TextWriterTraceListener(TextWriter, String) . В примере создается StreamWriter, а затем ссылается на StreamWriter при создании TextWriterTraceListener, который затем добавляется в TraceListenerCollection. Пример записывает два сообщения в этот TextWriterTraceListener, а затем записывает сообщение для всех TraceListener объектов в TraceListenerCollection. Наконец, он очищает и закрывает 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();
        }
    }
}

См. также раздел

Применяется к

TextWriterTraceListener(String, String)

Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs
Исходный код:
TextWriterTraceListener.cs

Инициализирует новый экземпляр класса TextWriterTraceListener с заданным именем, используя этот файл в качестве получателя выходных данных отладки и трассировки.

public TextWriterTraceListener (string? fileName, string? name);
public TextWriterTraceListener (string fileName, string name);

Параметры

fileName
String

Имя файла, в который осуществляет запись объект TextWriterTraceListener.

name
String

Имя нового экземпляра.

Исключения

Поток имеет значение null.

Примеры

В следующем примере кода создается TextWriterTraceListener с помощью конструктора TextWriterTraceListener(String, String) , а затем добавляется в TraceListenerCollection. Пример записывает два сообщения в этот TextWriterTraceListener, а затем записывает сообщение для всех TraceListener объектов в TraceListenerCollection. Наконец, он очищает и закрывает 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();
        }
    }
}

Комментарии

Этот конструктор инициализирует Name свойство параметром name или пустой строкой (""), если name параметр имеет значение null.

См. также раздел

Применяется к