EventSchemaTraceListener Класс

Определение

Направляет результаты трассировки или отладки сквозных событий в совместимый со схемой файл журнала в XML-представлении.Directs tracing or debugging output of end-to-end events to an XML-encoded, schema-compliant log file.

public ref class EventSchemaTraceListener : System::Diagnostics::TextWriterTraceListener
public class EventSchemaTraceListener : System.Diagnostics.TextWriterTraceListener
type EventSchemaTraceListener = class
    inherit TextWriterTraceListener
Public Class EventSchemaTraceListener
Inherits TextWriterTraceListener
Наследование

Примеры

В следующем примере кода показано, как использовать EventSchemaTraceListener класс.The following code example demonstrates how to use the EventSchemaTraceListener class.


///////////////////////////////////////////////////////////////////////
//
// EventSchemaTraceListener.cpp : main project file.
// Expected Output:
// 1)
//      EventSchemaTraceListener CPP Sample
//
//      IsThreadSafe? True
//      BufferSize =  65536
//      MaximumFileSize =  20480000
//      MaximumNumberOfFiles =  2
//      Name =  eventListener
//      TraceLogRetentionOption = LimitedCircularFiles
//      TraceOutputOptions = DateTime, Timestamp, ProcessId
//
//      Press the enter key to exit
//
// 2) An output file is created named TraceOutput.xml.  It will be
//    opened and displayed in Microsoft Notepad.
//
// NOTE 1:
//  Under certain circumstances, the VS C++ compiler will treat
//          Console::WriteLine("MyText = " + MyVar);
//        differently then the VS CSharp compiler.
//        The C++ compiler will produce error C3063, whereas the 
//        CSharp compiler accepts the statement.
//        This occurs when the VS C++ compiler cannot determine the
//        datatype of "MyVar" because it is an enumeration type.
//        The solution is:
//        Use either of the following two methods:
//          Console::WriteLine("MyText = {0} " , MyVar);
//          Console::WriteLine("MyText =  " + MyVar.ToString());
//
//        Although not specific to this particular pieces of code,
//        this is demonstrated below in the Display function:  The
//        last two members, TraceLogRetentionOption, and
//        TraceOutputOptions, are enumerations, and cannot simply be
//        concatenated into Console::WriteLine.
//
///////////////////////////////////////////////////////////////////////
#using <System.dll>
#using <System.Core.dll>

#define NOCONFIGFILE 1
using namespace System;
using namespace System::IO;
using namespace System::Diagnostics;


[STAThreadAttribute]
void main()
{
    Console::WriteLine("EventSchemaTraceListener CPP Sample\n");

    File::Delete("TraceOutput.xml");
    TraceSource ^ ts = gcnew TraceSource("TestSource");


#if NOCONFIGFILE
    ts->Listeners->Add(gcnew EventSchemaTraceListener("TraceOutput.xml",
                            "eventListener", 65536,
                            TraceLogRetentionOption::LimitedCircularFiles,
                            20480000, 2));
    ts->Listeners["eventListener"]->TraceOutputOptions =
                                    TraceOptions::DateTime |
                                    TraceOptions::ProcessId |
                                    TraceOptions::Timestamp;
#endif

    EventSchemaTraceListener ^ ESTL =
               (EventSchemaTraceListener^)(ts->Listeners["eventListener"]);


    Console::WriteLine("IsThreadSafe?            = " + ESTL->IsThreadSafe);
    Console::WriteLine("BufferSize               = " + ESTL->BufferSize);
    Console::WriteLine("MaximumFileSize          = " + ESTL->MaximumFileSize);
    Console::WriteLine("MaximumNumberOfFiles     = " + ESTL->MaximumNumberOfFiles);
    Console::WriteLine("Name                     = " + ESTL->Name);
    Console::WriteLine("TraceLogRetentionOption  = " + ESTL->TraceLogRetentionOption.ToString());
    Console::WriteLine("TraceOutputOptions       = {0}\n", ESTL->TraceOutputOptions);

    ts->Switch->Level = SourceLevels::All;
    String ^ testString = "<Test><InnerElement Val=\"1\" />"
                        + "<InnerElement Val=\"Data\"/>"
                        + "<AnotherElement>11</AnotherElement></Test>";

    UnescapedXmlDiagnosticData ^ unXData = gcnew UnescapedXmlDiagnosticData(testString);
    ts->TraceData(TraceEventType::Error, 38, unXData);
    ts->TraceEvent(TraceEventType::Error, 38, testString);
    ts->Flush();
    ts->Close();

    Process::Start("notepad.exe", "TraceOutput.xml");
    Console::WriteLine("\nPress the enter key to exit");
    Console::ReadLine();
}
#define NOCONFIGFILE
using System;
using System.IO;
using System.Xml;
using System.Xml.XPath;
using System.Diagnostics;

class testClass
{
    [STAThreadAttribute]
    static void Main()
    {
        File.Delete("TraceOutput.xml");
        TraceSource ts = new TraceSource("TestSource");
#if NOCONFIGFILE
        //ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000, 2));
        ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener"));
        ts.Listeners["eventListener"].TraceOutputOptions = TraceOptions.DateTime | TraceOptions.ProcessId | TraceOptions.Timestamp;
#endif
        ts.Switch.Level = SourceLevels.All;
        string testString = "<Test><InnerElement Val=\"1\" /><InnerElement Val=\"Data\"/><AnotherElement>11</AnotherElement></Test>";
        UnescapedXmlDiagnosticData unXData = new UnescapedXmlDiagnosticData(testString);
        ts.TraceData(TraceEventType.Error, 38, unXData);
        ts.TraceEvent(TraceEventType.Error, 38, testString);
        Trace.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml"));
        Trace.Write("test", "test");
        Trace.Flush();
        ts.Flush();
        ts.Close();
        DisplayProperties(ts);
        Process.Start("notepad.exe", "TraceOutput.xml");
        Console.WriteLine("Press the enter key to exit");
        Console.ReadLine();
    }
    private static void DisplayProperties(TraceSource ts)
    {
        Console.WriteLine("IsThreadSafe? " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).IsThreadSafe);
        Console.WriteLine("BufferSize =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).BufferSize);
        Console.WriteLine("MaximumFileSize =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).MaximumFileSize);
        Console.WriteLine("MaximumNumberOfFiles =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).MaximumNumberOfFiles);
        Console.WriteLine("Name =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).Name);
        Console.WriteLine("TraceLogRetentionOption =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).TraceLogRetentionOption);
        Console.WriteLine("TraceOutputOptions =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).TraceOutputOptions);
    }
}
#Const NOCONFIGFILE = True
Imports System.IO
Imports System.Xml
Imports System.Xml.XPath
Imports System.Diagnostics

Class testClass

    <STAThreadAttribute()> _
    Shared Sub Main()
        File.Delete("TraceOutput.xml")
        Dim ts As New TraceSource("TestSource")
#If NOCONFIGFILE Then
        ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000, 2))
        ts.Listeners("eventListener").TraceOutputOptions = TraceOptions.DateTime Or TraceOptions.ProcessId Or TraceOptions.Timestamp
#End If
        ts.Switch.Level = SourceLevels.All
        Dim testString As String = "<Test><InnerElement Val=""1"" /><InnerElement Val=""Data""/><AnotherElement>11</AnotherElement></Test>"
        Dim unXData As New UnescapedXmlDiagnosticData(testString)
        ts.TraceData(TraceEventType.Error, 38, unXData)
        ts.TraceEvent(TraceEventType.Error, 38, testString)
        ts.Flush()
        ts.Close()
        DisplayProperties(ts)
        Process.Start("notepad.exe", "TraceOutput.xml")
        Console.WriteLine("Press the enter key to exit")
        Console.ReadLine()

    End Sub

    Private Shared Sub DisplayProperties(ByVal ts As TraceSource)
        Console.WriteLine("IsThreadSafe? " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).IsThreadSafe.ToString())
        Console.WriteLine("BufferSize =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).BufferSize.ToString())
        Console.WriteLine("MaximumFileSize =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).MaximumFileSize.ToString())
        Console.WriteLine("MaximumNumberOfFiles =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).MaximumNumberOfFiles.ToString())
        Console.WriteLine("Name =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).Name)
        Console.WriteLine("TraceLogRetentionOption =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).TraceLogRetentionOption.ToString())
        Console.WriteLine("TraceOutputOptions =  " + CType(ts.Listeners("eventListener"), EventSchemaTraceListener).TraceOutputOptions.ToString())
    End Sub
End Class

Комментарии

EventSchemaTraceListenerКласс обеспечивает трассировку комплексных событий, соответствующих схеме.The EventSchemaTraceListener class provides tracing of end-to-end schema-compliant events. Можно использовать сквозную трассировку для системы с разнородными компонентами, которые пересекают границы потоков, AppDomain , процессов и компьютеров.You can use end-to-end tracing for a system that has heterogeneous components that cross thread, AppDomain, process, and computer boundaries. Определена стандартизированная схема событий (см. представление событий для потребителей событий), чтобы включить трассировку через эти границы.A standardized event schema (see Event Representation for Event Consumers) has been defined to enable tracing across these boundaries. Схема включает добавление пользовательских, соответствующих схеме элементов.The schema enables the addition of custom, schema-compliant elements. Для вывода данных о событии можно использовать средство Service Trace Viewer (SvcTraceViewer.exe) .You can use the Service Trace Viewer Tool (SvcTraceViewer.exe) to display the event data.

EventSchemaTraceListener настраивается для повышения производительности ведения журнала с помощью неявной поддержки трассировки без блокировки.EventSchemaTraceListener is tuned for logging performance with implicit support for lock-free tracing.

EventSchemaTraceListenerКласс преобразует данные трассировки и отладки в поток текста в кодировке XML.The EventSchemaTraceListener class converts tracing and debugging information into an XML-encoded text stream. Описание выходных данных XML приведено в таблицах далее в этом разделе.The description of the XML output is shown in the tables later in this section.

Вы можете включить или отключить EventSchemaTraceListener объект через файл конфигурации приложения, а затем использовать настроенный EventSchemaTraceListener объект в приложении.You can enable or disable an EventSchemaTraceListener object through the application configuration file, and then use the configured EventSchemaTraceListener object in your application. Кроме того, можно создать EventSchemaTraceListener объект в коде.Alternately, you can create an EventSchemaTraceListener object in your code. Рекомендуется включить прослушиватели трассировки с помощью файла конфигурации приложения.We recommend that you enable trace listeners through the application configuration file. Сведения об использовании файлов конфигурации для трассировки и отладки см. в разделе схема параметров трассировки и отладки.For information about the use of configuration files for tracing and debugging, see Trace and Debug Settings Schema.

Чтобы настроить EventSchemaTraceListener объект, измените файл конфигурации, соответствующий имени приложения.To configure an EventSchemaTraceListener object, modify the configuration file that corresponds to the name of your application. В этом файле можно добавлять, удалять или задавать свойства прослушивателя.In this file, you can add, remove, or set the properties for a listener. Файл конфигурации следует отформатировать следующим образом:The configuration file should be formatted as follows:

<configuration>  
    <system.diagnostics>  
        <sources>  
            <source name="TestSource" >  
                <listeners>  
                    <!--Remove the default trace listener for better performance.-->  
                    <remove name="Default"/>  
                    <!--Note: Removing the default trace listener prevents the dialog box   
                    from being displayed for Debug.Fail or Debug.Assert commands that are   
                    executed in user mode.-->  
                    <add name="eventListener"   
                      type="System.Diagnostics.EventSchemaTraceListener,  system.core"  
                      initializeData="TraceOutput.xml"   
                      traceOutputOptions="ProcessId, DateTime, Timestamp"   
                      bufferSize="65536"  
                      maximumFileSize="20480000"  
                      logRetentionOption="LimitedCircularFiles"  
                      maximumNumberOfFiles="2"/>  
                </listeners>  
            </source>  
        </sources>  
    </system.diagnostics>  

EventSchemaTraceListenerКласс наследует Filter свойство от базового класса TraceListener .The EventSchemaTraceListener class inherits the Filter property from the base class TraceListener. FilterСвойство позволяет получить дополнительный уровень фильтрации выходных данных трассировки на прослушивателе.The Filter property allows for an additional level of trace output filtering at the listener. Если фильтр имеется, Trace Методы прослушивателя трассировки вызывают ShouldTrace метод фильтра, чтобы определить, следует ли выдавать трассировку.If a filter is present, the Trace methods of the trace listener call the ShouldTrace method of the filter to determine whether to emit the trace.

При попытке записи в файл, который используется или недоступен, суффикс GUID автоматически добавляется к имени файла.If an attempt is made to write to a file that is being used or is unavailable, a GUID suffix is automatically added to the file name.

Примечание

Методы прослушивателя предназначены для вызова методами Debug Trace классов, и TraceSource .Listener methods are intended to be called by methods of the Debug, Trace, and TraceSource classes. Не вызывайте методы прослушивателя непосредственно из кода приложения.Do not call the listener methods directly from application code. EventSchemaTraceListenerПрослушиватель в основном предназначен для использования TraceSource классом.The EventSchemaTraceListener listener is primarily intended for use by the TraceSource class.

В следующей таблице описаны элементы и атрибуты выходных данных XML.The following table describes the elements and attributes of the XML output.

ЭлементElement АтрибутыAttributes Выходные данныеOutput ПримечанияNotes
CallStack NoneNone Зависит от наличия Callstack флага в TraceOutputOptions свойстве.Depends on the presence of the Callstack flag in the TraceOutputOptions property. Специальные символы, такие как > или <, заменяются escape-последовательностями.Special characters such as > or < are replaced with escape sequences. См. таблицу преобразования escape-символов в следующей таблице.See the escaped character translation table in the next table.
Computer NoneNone Всегда присутствует.Always present. Этот элемент представляет значение MachineName Свойства.This element represents the value of the MachineName property.
Correlation ActivityID Всегда присутствует.Always present. Если параметр ActivityID не указан, по умолчанию используется пустой GUID.If ActivityID is not specified, the default is an empty GUID.
RelatedActivityID Зависит от наличия relatedActivityId параметра в Trace вызове метода.Depends on the presence of the relatedActivityId parameter in the Trace method call. RelatedActivityIDАтрибут соответствует relatedActivityId параметру TraceTransfer метода.The RelatedActivityID attribute corresponds to the relatedActivityId parameter of the TraceTransfer method.
Data NoneNone Всегда присутствует.Always present. Этот элемент представляет входные данные параметра ( data ).This element represents parameter input (data). Для каждого объекта данных предоставляется один элемент.One element is provided for each data object. В случае с журналами событий Data элемент содержит экранированные XML-данные.In the case of event logs, the Data element contains escaped XML data. В случае с журналами данных Data элемент содержит неэкранированные данные.In the case of data logs, the Data element contains unescaped data. Выходные данные журнала данных используют метод переданных ToString объектов данных.The data log output uses the ToString method of the passed-in data objects.
Event NoneNone Всегда присутствует.Always present. Этот элемент содержит событие трассировки.This element contains a trace event.
EventData NoneNone Есть для журналов событий.Present for event logs. Этот элемент представляет входные данные параметра ( message , args ).This element represents parameter input (message, args). Он содержит Data элементы с экранированными XML-данными, созданными путем вызова TraceEvent метода.It contains Data elements with escaped XML data that is created by calling the TraceEvent method.
EventID NoneNone Всегда присутствует.Always present. Этот элемент представляет входные данные параметра ( id ).This element represents parameter input (id).
Execution ProcessID Зависит от наличия ProcessId флага в TraceOutputOptions свойстве.Depends on the presence of the ProcessId flag in the TraceOutputOptions property. ProcessIDАтрибут задается в TraceEventCache .The ProcessID attribute is specified in the TraceEventCache. В операционных системах Microsoft Windows 98 и Windows Millennium Edition, если значение параметра больше ProcessID 2 147 483 647, оно является положительным представлением отрицательного числа и должно быть преобразовано для получения правильного идентификатора процесса.On the Microsoft Windows 98 and Windows Millennium Edition operating systems, if ProcessID is larger than 2,147,483,647, it is a positive representation of a negative number and should be converted to obtain the correct process identifier.
ThreadID Отображается, если имеется ProcessID .Present when ProcessID is present. ThreadIDАтрибут задается в TraceEventCache .The ThreadID attribute is specified in the TraceEventCache.
Level NoneNone Всегда присутствует.Always present. Этот элемент представляет входные данные параметра (числовое значение eventType ).This element represents parameter input (the numeric value of eventType). Значения параметров, превышающие 255, выводятся как уровень 8, который представляет TraceEventType.Information .Parameter values that are larger than 255 are output as a level 8, which represents TraceEventType.Information. Типы событий трассировки Critical ,,, Error Warning Information и Verbose выводятся в виде уровней 1, 2, 4, 8 и 10 соответственно.Trace event types Critical, Error, Warning, Information, and Verbose are output as levels 1, 2, 4, 8, and 10, respectively.
LogicalOperationStack NoneNone Зависит от наличия LogicalOperationStack флага в TraceOutputOptions свойстве.Depends on the presence of the LogicalOperationStack flag in the TraceOutputOptions property. Может существовать только одна логическая операция.Only one logical operation can exist. Таким образом, значения записываются как LogicalOperation узлы в LogicalOperationStack элементе.Therefore, the values are written as LogicalOperation nodes under the LogicalOperationStack element.
OpCode NoneNone Отображается Level , если больше 255.Present when Level is greater than 255. Этот элемент представляет типы событий трассировки, имеющие числовые значения, превышающие 255.This element represents Trace event types that have numeric values greater than 255. Start, Stop , Suspend , Resume или Transfer выводятся как уровни 1, 2, 4, 8 и 10 соответственно.Start, Stop, Suspend, Resume, or Transfer are output as levels 1, 2, 4, 8, and 10, respectively.
Provider GUID Всегда присутствует.Always present. Всегда пусто.Always empty.
RenderingInfo Culture Всегда присутствует.Always present. Этот атрибут представляет строку ресурса для типа события.This attribute represents a resource string for the event type. Он всегда имеет значение en-EN \ .It is always "en-EN\".
System Name Всегда присутствует.Always present.
TimeCreated SystemTime Зависит от наличия DateTime флага в TraceOutputOptions свойстве.Depends on the presence of the DateTime flag in the TraceOutputOptions property. Время — это значение TraceEventCache.DateTime Свойства.The time is the value of the TraceEventCache.DateTime property. Это свойство представлено в формате всемирного координированного времениThis property is expressed as Coordinated Universal Time
TimeStamp NoneNone Зависит от наличия Timestamp флага в TraceOutputOptions свойстве.Depends on the presence of the Timestamp flag in the TraceOutputOptions property. Этот элемент указан в TraceEventCache .This element is specified in the TraceEventCache.
UserData NoneNone Есть для журналов данных.Present for data logs. Этот элемент содержит Data элементы с неэкранированными, предоставленными пользователем данными из TraceData метода.This element contains Data elements with unescaped, user-provided data from a TraceData method.

В следующей таблице показаны символы, которые экранированы в выходных данных XML.The following table shows the characters that are escaped in the XML output. Экранирование происходит во всех элементах и атрибутах, за исключением UserData элемента, который содержит предоставленные пользователем неэкранированные данные.Escaping occurs in all the elements and attributes except for the UserData element, which contains user-provided, unescaped data. UserDataЭлемент является результатом вызова TraceData метода.The UserData element is a result of calls to the TraceData method.

Escape-символEscaped character ЗначениеValue
& &
< <
> >
"" "
|'
0xD0xD &#XD&#xD;
0xA0xA &#Сообщен&#xA;

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

EventSchemaTraceListener(String)

Инициализирует новый экземпляр класса EventSchemaTraceListener, используя указанный файл в качестве получателя выходных данных отладки и трассировки.Initializes a new instance of the EventSchemaTraceListener class, using the specified file as the recipient of debugging and tracing output.

EventSchemaTraceListener(String, String)

Инициализирует новый экземпляр класса EventSchemaTraceListener заданным именем, используя указанный файл в качестве получателя выходных данных отладки и трассировки.Initializes a new instance of the EventSchemaTraceListener class with the specified name, using the specified file as the recipient of debugging and tracing output.

EventSchemaTraceListener(String, String, Int32)

Инициализирует новый экземпляр класса EventSchemaTraceListener заданным именем и указанным размером буфера, используя указанный файл в качестве получателя выходных данных отладки и трассировки.Initializes a new instance of the EventSchemaTraceListener class with the specified name and specified buffer size, using the specified file as the recipient of debugging and tracing output.

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption)

Инициализирует новый экземпляр класса EventSchemaTraceListener заданным именем и указанным размером буфера, используя указанный файл с заданной политикой хранения журнала в качестве получателя выходных данных отладки и трассировки.Initializes a new instance of the EventSchemaTraceListener class with the specified name and specified buffer size, using the specified file with the specified log retention policy as the recipient of the debugging and tracing output.

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64)

Инициализирует новый экземпляр класса EventSchemaTraceListener заданным именем и указанным размером буфера, используя указанный файл с заданной политикой хранения и максимальным размером журнала в качестве получателя выходных данных отладки и трассировки.Initializes a new instance of the EventSchemaTraceListener class with the specified name and specified buffer size, using the specified file with the specified log retention policy and maximum size as the recipient of the debugging and tracing output.

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64, Int32)

Инициализирует новый экземпляр класса EventSchemaTraceListener заданным именем и указанным размером буфера, используя в качестве получателя выходных данных отладки и трассировки указанный файл с заданной политикой хранения и максимальным размером журнала, а также счетчиком файлов.Initializes a new instance of the EventSchemaTraceListener class with the specified name and specified buffer size, using the specified file with the specified log retention policy, maximum size, and file count as the recipient of the debugging and tracing output.

Свойства

Attributes

Возвращает настраиваемые атрибуты прослушивателя трассировки, определенные в файле конфигурации приложения.Gets the custom trace listener attributes defined in the application configuration file.

(Унаследовано от TraceListener)
BufferSize

Возвращает размер выходного буфера.Gets the size of the output buffer.

Filter

Получает или задает фильтр трассировки для прослушивателя трассировки.Gets or sets the trace filter for the trace listener.

(Унаследовано от TraceListener)
IndentLevel

Возвращает или задает уровень отступа.Gets or sets the indent level.

(Унаследовано от TraceListener)
IndentSize

Возвращает или задает число пробелов в отступе.Gets or sets the number of spaces in an indent.

(Унаследовано от TraceListener)
IsThreadSafe

Возвращает значение, указывающее, является ли прослушиватель трассировки потокобезопасным.Gets a value indicating whether the trace listener is thread safe.

MaximumFileSize

Возвращает максимальный размер файла журнала.Gets the maximum size of the log file.

MaximumNumberOfFiles

Возвращает максимальное количество файлов журнала.Gets the maximum number of log files.

Name

Возвращает или задает имя для данного TraceListener.Gets or sets a name for this TraceListener.

(Унаследовано от TraceListener)
NeedIndent

Возвращает или задает значение, указывающее, нужен ли отступ в выходных данных.Gets or sets a value indicating whether to indent the output.

(Унаследовано от TraceListener)
TraceLogRetentionOption

Возвращает для файла параметр хранения журнала трассировки.Gets the trace log retention option for the file.

TraceOutputOptions

Возвращает или задает параметры выходных данных трассировки.Gets or sets the trace output options.

(Унаследовано от TraceListener)
Writer

Возвращает или задает основной модуль записи текста, записывающий данные в файл журнала.Gets or sets the underlying text writer that writes to the log file.

Методы

Close()

Закрывает файл журнала данного прослушивателя. Теперь этот журнал не будет получать выходные данные отладки или трассировки.Closes the log file for this listener so that it no longer receives tracing or debugging output.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем TraceListener.Releases all resources used by the TraceListener.

(Унаследовано от TraceListener)
Dispose(Boolean)

Удаляет этот объект TextWriterTraceListener.Disposes this TextWriterTraceListener object.

(Унаследовано от TextWriterTraceListener)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Fail(String)

Посылает сообщение об ошибке в прослушиватель, создаваемый при реализации класса TraceListener.Emits an error message to the listener you create when you implement the TraceListener class.

(Унаследовано от TraceListener)
Fail(String, String)

Записывает в файл журнала сведения об ошибках, в том числе базовое и подробное сообщение об ошибке.Writes error information, including a basic error message and a detailed error message, to the log file.

Flush()

Вызывает запись буферизованных данных в журнал этого прослушивателя.Causes buffered data to be written to the log for this listener.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetSupportedAttributes()

Возвращает настраиваемые атрибуты конфигурации XML, поддерживаемые прослушивателем трассировки.Gets the custom XML configuration attributes that the trace listener supports.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Записывает в файл журнала информацию трассировки, единичный объект данных и сведения о событии.Writes trace information, a single data object, and event information to the log file.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Записывает в файл журнала информацию трассировки, несколько объектов данных и сведения о событии.Writes trace information, multiple data objects, and event information to the log file.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Записывает сведения трассировки и сведения о событиях в специальные выходные данные прослушивателя.Writes trace and event information to the listener specific output.

(Унаследовано от TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Записывает в файл журнала информацию трассировки, сообщение и сведения о событиях.Writes trace information, a message, and event information to the log file.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Записывает в файл журнала информацию трассировки, форматированное сообщение и сведения о событиях.Writes trace information, a formatted message, and event information to the log file.

TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Записывает в файл журнала информацию трассировки, включая удостоверение связанного действия, сообщение и сведения о событии.Writes trace information, including the identity of a related activity, a message, and event information, to the log file.

Write(Object)

Записывает значение метода ToString() объекта в прослушиватель, создаваемый при реализации класса TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Унаследовано от TraceListener)
Write(Object, String)

Записывает имя категории и значение метода ToString() объекта в прослушиватель, создаваемый при реализации класса TraceListener.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Унаследовано от TraceListener)
Write(String)

Записывает сообщение в файл журнала, не указывая какой-либо дополнительной контекстной информации.Writes a message to the log file without providing any additional context information.

Write(String, String)

Записывает имя категории и сообщение в прослушиватель, создаваемый при реализации класса TraceListener.Writes a category name and a message to the listener you create when you implement the TraceListener class.

(Унаследовано от TraceListener)
WriteIndent()

Записывает отступ в прослушиватель, создаваемый при реализации этого класса, и восстанавливает для свойства NeedIndent значение false.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

(Унаследовано от TraceListener)
WriteLine(Object)

Записывает значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Унаследовано от TraceListener)
WriteLine(Object, String)

Записывает имя категории и значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Унаследовано от TraceListener)
WriteLine(String)

Записывает в файл журнала сообщение, после которого следует текущий разделитель строк, без какой-либо дополнительной контекстной информации.Writes a message followed by the current line terminator to the log file without providing any additional context information.

WriteLine(String, String)

Записывает имя категории и сообщение, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Унаследовано от TraceListener)

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