EventSchemaTraceListener Klasa

Definicja

Kieruje śledzenie lub debugowanie danych wyjściowych z kompleksowych zdarzeń do pliku dziennika zgodnego ze schematem 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
Dziedziczenie

Przykłady

Poniższy przykład kodu demonstruje, jak używać EventSchemaTraceListener klasy.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

Uwagi

EventSchemaTraceListenerKlasa zawiera śledzenie kompleksowych zdarzeń zgodnych ze schematem.The EventSchemaTraceListener class provides tracing of end-to-end schema-compliant events. Można użyć kompleksowego śledzenia dla systemu, który ma heterogeniczne składniki, które zawierają współzależności między wątkami, AppDomain procesami i komputerami.You can use end-to-end tracing for a system that has heterogeneous components that cross thread, AppDomain, process, and computer boundaries. Zdefiniowano standardowy schemat zdarzeń (zobacz reprezentacja zdarzeń dla odbiorców zdarzeń), aby umożliwić śledzenie w ramach tych granic.A standardized event schema (see Event Representation for Event Consumers) has been defined to enable tracing across these boundaries. Schemat włącza Dodawanie niestandardowych elementów zgodnych ze schematem.The schema enables the addition of custom, schema-compliant elements. Aby wyświetlić dane zdarzenia, można użyć narzędzia Podgląd śledzenia usługi (SvcTraceViewer.exe) .You can use the Service Trace Viewer Tool (SvcTraceViewer.exe) to display the event data.

EventSchemaTraceListener jest dostrojony do rejestrowania wydajności z niejawną obsługą śledzenia bez blokady.EventSchemaTraceListener is tuned for logging performance with implicit support for lock-free tracing.

EventSchemaTraceListenerKlasa konwertuje informacje o śledzeniu i debugowaniu na strumień tekstowy zakodowany w formacie XML.The EventSchemaTraceListener class converts tracing and debugging information into an XML-encoded text stream. Opis danych wyjściowych XML znajduje się w tabeli w dalszej części tej sekcji.The description of the XML output is shown in the tables later in this section.

Możesz włączyć lub wyłączyć EventSchemaTraceListener obiekt za pomocą pliku konfiguracji aplikacji, a następnie użyć skonfigurowanego EventSchemaTraceListener obiektu w aplikacji.You can enable or disable an EventSchemaTraceListener object through the application configuration file, and then use the configured EventSchemaTraceListener object in your application. Alternatywnie można utworzyć EventSchemaTraceListener obiekt w kodzie.Alternately, you can create an EventSchemaTraceListener object in your code. Zalecamy włączenie odbiorników śledzenia za pomocą pliku konfiguracji aplikacji.We recommend that you enable trace listeners through the application configuration file. Aby uzyskać informacje o używaniu plików konfiguracji do śledzenia i debugowania, zobacz Schemat ustawień śledzenia i debugowania.For information about the use of configuration files for tracing and debugging, see Trace and Debug Settings Schema.

Aby skonfigurować EventSchemaTraceListener obiekt, należy zmodyfikować plik konfiguracji, który odnosi się do nazwy aplikacji.To configure an EventSchemaTraceListener object, modify the configuration file that corresponds to the name of your application. W tym pliku można dodawać, usuwać lub ustawiać właściwości odbiornika.In this file, you can add, remove, or set the properties for a listener. Plik konfiguracji powinien być sformatowany w następujący sposób: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>  

EventSchemaTraceListenerKlasa dziedziczy Filter Właściwość z klasy bazowej TraceListener .The EventSchemaTraceListener class inherits the Filter property from the base class TraceListener. FilterWłaściwość pozwala na dodatkowy poziom filtrowania danych wyjściowych śledzenia na odbiorniku.The Filter property allows for an additional level of trace output filtering at the listener. Jeśli filtr jest obecny, Trace metody odbiornika śledzenia wywołują ShouldTrace metodę filtru, aby określić, czy ma być emitowane śledzenie.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.

Jeśli podjęta zostanie próba zapisu do pliku, który jest używany lub jest niedostępny, sufiks identyfikatora GUID jest automatycznie dodawany do nazwy pliku.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.

Uwaga

Metody odbiornika mają być wywoływane przy użyciu metod Debug Trace klasy,, i TraceSource .Listener methods are intended to be called by methods of the Debug, Trace, and TraceSource classes. Nie wywołuj metod odbiornika bezpośrednio z kodu aplikacji.Do not call the listener methods directly from application code. EventSchemaTraceListenerOdbiornik jest przeznaczony głównie do użytku przez TraceSource klasę.The EventSchemaTraceListener listener is primarily intended for use by the TraceSource class.

W poniższej tabeli opisano elementy i atrybuty danych wyjściowych XML.The following table describes the elements and attributes of the XML output.

ElementElement AtrybutyAttributes Dane wyjścioweOutput UwagiNotes
CallStack BrakNone Zależy od obecności Callstack flagi we TraceOutputOptions właściwości.Depends on the presence of the Callstack flag in the TraceOutputOptions property. Znaki specjalne, takie jak > lub <, są zastępowane sekwencjami ucieczki.Special characters such as > or < are replaced with escape sequences. Zobacz tabelę translacji znaków ucieczki w następnej tabeli.See the escaped character translation table in the next table.
Computer BrakNone Zawsze obecne.Always present. Ten element reprezentuje wartość MachineName właściwości.This element represents the value of the MachineName property.
Correlation ActivityID Zawsze obecne.Always present. Jeśli ActivityID nie jest określony, wartość domyślna to pusty identyfikator GUID.If ActivityID is not specified, the default is an empty GUID.
RelatedActivityID Zależy od obecności relatedActivityId parametru w Trace wywołaniu metody.Depends on the presence of the relatedActivityId parameter in the Trace method call. Ten RelatedActivityID atrybut odnosi się do relatedActivityId parametru TraceTransfer metody.The RelatedActivityID attribute corresponds to the relatedActivityId parameter of the TraceTransfer method.
Data BrakNone Zawsze obecne.Always present. Ten element reprezentuje parametr wejściowy ( data ).This element represents parameter input (data). Jeden element jest udostępniany dla każdego obiektu danych.One element is provided for each data object. W przypadku dzienników zdarzeń Data element zawiera dane XML o zmienionym znaczeniu.In the case of event logs, the Data element contains escaped XML data. W przypadku dzienników danych Data element zawiera niezmienione dane.In the case of data logs, the Data element contains unescaped data. Dane wyjściowe dziennika danych korzystają z ToString metody przekazywania obiektów danych.The data log output uses the ToString method of the passed-in data objects.
Event BrakNone Zawsze obecne.Always present. Ten element zawiera zdarzenie śledzenia.This element contains a trace event.
EventData BrakNone Występuje w przypadku dzienników zdarzeń.Present for event logs. Ten element reprezentuje dane wejściowe parametru ( message , args ).This element represents parameter input (message, args). Zawiera Data elementy z danymi XML, które są tworzone przez wywołanie TraceEvent metody.It contains Data elements with escaped XML data that is created by calling the TraceEvent method.
EventID BrakNone Zawsze obecne.Always present. Ten element reprezentuje parametr wejściowy ( id ).This element represents parameter input (id).
Execution ProcessID Zależy od obecności ProcessId flagi we TraceOutputOptions właściwości.Depends on the presence of the ProcessId flag in the TraceOutputOptions property. Ten ProcessID atrybut jest określony w TraceEventCache .The ProcessID attribute is specified in the TraceEventCache.
ThreadID Obecny, gdy ProcessID jest obecny.Present when ProcessID is present. Ten ThreadID atrybut jest określony w TraceEventCache .The ThreadID attribute is specified in the TraceEventCache.
Level BrakNone Zawsze obecne.Always present. Ten element reprezentuje dane wejściowe parametru (wartość liczbowa eventType ).This element represents parameter input (the numeric value of eventType). Wartości parametrów, które są większe niż 255 są wyprowadzane jako poziom 8, który reprezentuje TraceEventType.Information .Parameter values that are larger than 255 are output as a level 8, which represents TraceEventType.Information. Typy zdarzeń śledzenia Critical ,,, Error Warning Information i Verbose są wyprowadzane jako poziomy 1, 2, 4, 8 i 10.Trace event types Critical, Error, Warning, Information, and Verbose are output as levels 1, 2, 4, 8, and 10, respectively.
LogicalOperationStack BrakNone Zależy od obecności LogicalOperationStack flagi we TraceOutputOptions właściwości.Depends on the presence of the LogicalOperationStack flag in the TraceOutputOptions property. Może istnieć tylko jedna operacja logiczna.Only one logical operation can exist. W związku z tym wartości są zapisywane jako LogicalOperation węzły w LogicalOperationStack elemencie.Therefore, the values are written as LogicalOperation nodes under the LogicalOperationStack element.
OpCode BrakNone Występuje, gdy Level jest większy niż 255.Present when Level is greater than 255. Ten element reprezentuje typy zdarzeń śledzenia, które mają wartości liczbowe większe niż 255.This element represents Trace event types that have numeric values greater than 255. Start, Stop , Suspend , Resume lub Transfer są wyprowadzane odpowiednio na poziomie 1, 2, 4, 8 i 10.Start, Stop, Suspend, Resume, or Transfer are output as levels 1, 2, 4, 8, and 10, respectively.
Provider GUID Zawsze obecne.Always present. Zawsze puste.Always empty.
RenderingInfo Culture Zawsze obecne.Always present. Ten atrybut reprezentuje ciąg zasobu dla typu zdarzenia.This attribute represents a resource string for the event type. Jest zawsze "en-EN \ ".It is always "en-EN\".
System Name Zawsze obecne.Always present.
TimeCreated SystemTime Zależy od obecności DateTime flagi we TraceOutputOptions właściwości.Depends on the presence of the DateTime flag in the TraceOutputOptions property. Czas jest wartością TraceEventCache.DateTime właściwości.The time is the value of the TraceEventCache.DateTime property. Ta właściwość jest wyrażona jako uniwersalny czas koordynowanyThis property is expressed as Coordinated Universal Time
TimeStamp BrakNone Zależy od obecności Timestamp flagi we TraceOutputOptions właściwości.Depends on the presence of the Timestamp flag in the TraceOutputOptions property. Ten element jest określony w TraceEventCache .This element is specified in the TraceEventCache.
UserData BrakNone Obecne w przypadku dzienników danych.Present for data logs. Ten element zawiera Data elementy z niezmienionymi danymi dostarczonymi przez użytkownika z TraceData metody.This element contains Data elements with unescaped, user-provided data from a TraceData method.

W poniższej tabeli przedstawiono znaki, które są wyprowadzane w danych wyjściowych XML.The following table shows the characters that are escaped in the XML output. Ucieczki występuje we wszystkich elementach i atrybutach z wyjątkiem UserData elementu, który zawiera dane dostarczone przez użytkownika, niewyprowadzane.Escaping occurs in all the elements and attributes except for the UserData element, which contains user-provided, unescaped data. UserDataElement jest wynikiem wywołania TraceData metody.The UserData element is a result of calls to the TraceData method.

Znak poprzedzony znakiem ucieczkiEscaped character WartośćValue
& &
< <
> >
"" "
|'
0xD0xD &#xD&#xD;
0xA0xA &#XA&#xA;

Konstruktory

EventSchemaTraceListener(String)

Inicjuje nowe wystąpienie EventSchemaTraceListener klasy, używając określonego pliku jako odbiorcy debugowania i śledzenia danych wyjściowych.Initializes a new instance of the EventSchemaTraceListener class, using the specified file as the recipient of debugging and tracing output.

EventSchemaTraceListener(String, String)

Inicjuje nowe wystąpienie EventSchemaTraceListener klasy o określonej nazwie, używając określonego pliku jako odbiorcy debugowania i śledzenia danych wyjściowych.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)

Inicjuje nowe wystąpienie EventSchemaTraceListener klasy z określoną nazwą i określonym rozmiarem buforu, używając określonego pliku jako odbiorcy debugowania i śledzenia danych wyjściowych.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)

Inicjuje nowe wystąpienie EventSchemaTraceListener klasy z określoną nazwą i określonym rozmiarem buforu przy użyciu określonego pliku z określonymi zasadami przechowywania dziennika jako odbiorcą debugowania i śledzenia danych wyjściowych.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)

Inicjuje nowe wystąpienie EventSchemaTraceListener klasy z określoną nazwą i określonym rozmiarem buforu, używając określonego pliku z określonymi zasadami przechowywania dziennika i maksymalnym rozmiarem jako odbiorcy debugowania i śledzenia danych wyjściowych.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)

Inicjuje nowe wystąpienie EventSchemaTraceListener klasy z określoną nazwą i określonym rozmiarem buforu, przy użyciu określonego pliku z określonymi zasadami przechowywania dziennika, rozmiarem maksymalnym i liczbą plików jako odbiorcy debugowania i śledzenia danych wyjściowych.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.

Właściwości

Attributes

Pobiera atrybuty niestandardowego odbiornika śledzenia zdefiniowane w pliku konfiguracyjnym aplikacji.Gets the custom trace listener attributes defined in the application configuration file.

(Odziedziczone po TraceListener)
BufferSize

Pobiera rozmiar buforu wyjściowego.Gets the size of the output buffer.

Filter

Pobiera lub ustawia filtr śledzenia dla odbiornika śledzenia.Gets or sets the trace filter for the trace listener.

(Odziedziczone po TraceListener)
IndentLevel

Pobiera lub ustawia poziom wcięcia.Gets or sets the indent level.

(Odziedziczone po TraceListener)
IndentSize

Pobiera lub ustawia liczbę spacji w wcięcie.Gets or sets the number of spaces in an indent.

(Odziedziczone po TraceListener)
IsThreadSafe

Pobiera wartość wskazującą, czy odbiornik śledzenia jest bezpieczny wątkowo.Gets a value indicating whether the trace listener is thread safe.

MaximumFileSize

Pobiera maksymalny rozmiar pliku dziennika.Gets the maximum size of the log file.

MaximumNumberOfFiles

Pobiera maksymalną liczbę plików dziennika.Gets the maximum number of log files.

Name

Pobiera lub ustawia nazwę dla tego elementu TraceListener .Gets or sets a name for this TraceListener.

(Odziedziczone po TraceListener)
NeedIndent

Pobiera lub ustawia wartość wskazującą, czy mają być wcięte dane wyjściowe.Gets or sets a value indicating whether to indent the output.

(Odziedziczone po TraceListener)
TraceLogRetentionOption

Pobiera opcję przechowywania dziennika śledzenia dla pliku.Gets the trace log retention option for the file.

TraceOutputOptions

Pobiera lub ustawia opcje danych wyjściowych śledzenia.Gets or sets the trace output options.

(Odziedziczone po TraceListener)
Writer

Pobiera lub ustawia źródłowy składnik zapisywania tekstu, który zapisuje w pliku dziennika.Gets or sets the underlying text writer that writes to the log file.

Metody

Close()

Zamyka plik dziennika dla tego odbiornika, dzięki czemu nie otrzymuje już śledzenia lub debugowania danych wyjściowych.Closes the log file for this listener so that it no longer receives tracing or debugging output.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszelkie zasoby używane przez element TraceListener.Releases all resources used by the TraceListener.

(Odziedziczone po TraceListener)
Dispose(Boolean)

Usuwa ten TextWriterTraceListener obiekt.Disposes this TextWriterTraceListener object.

(Odziedziczone po TextWriterTraceListener)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
Fail(String)

Emituje komunikat o błędzie do odbiornika tworzonego podczas implementowania TraceListener klasy.Emits an error message to the listener you create when you implement the TraceListener class.

(Odziedziczone po TraceListener)
Fail(String, String)

Zapisuje informacje o błędzie, w tym podstawowy komunikat o błędzie i szczegółowy komunikat o błędzie, do pliku dziennika.Writes error information, including a basic error message and a detailed error message, to the log file.

Flush()

Powoduje, że buforowane dane są zapisywane w dzienniku dla tego odbiornika.Causes buffered data to be written to the log for this listener.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetSupportedAttributes()

Pobiera niestandardowe atrybuty konfiguracji XML, które obsługuje odbiornik śledzenia.Gets the custom XML configuration attributes that the trace listener supports.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Zapisuje informacje o śledzeniu, pojedynczy obiekt danych i informacje o zdarzeniu w pliku dziennika.Writes trace information, a single data object, and event information to the log file.

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

Zapisuje informacje o śledzeniu, wiele obiektów danych i informacje o zdarzeniach w pliku dziennika.Writes trace information, multiple data objects, and event information to the log file.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Zapisuje informacje o śledzeniu i zdarzeniu w danych wyjściowych określonego odbiornika.Writes trace and event information to the listener specific output.

(Odziedziczone po TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Zapisuje informacje o śledzeniu, komunikat i informacje o zdarzeniu w pliku dziennika.Writes trace information, a message, and event information to the log file.

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

Zapisuje informacje o śledzeniu, sformatowaną wiadomość i informacje o zdarzeniu w pliku dziennika.Writes trace information, a formatted message, and event information to the log file.

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

Zapisuje informacje o śledzeniu, w tym tożsamość powiązanego działania, komunikat i informacje o zdarzeniu, do pliku dziennika.Writes trace information, including the identity of a related activity, a message, and event information, to the log file.

Write(Object)

Zapisuje wartość ToString() metody obiektu do odbiornika tworzonego podczas implementowania TraceListener klasy.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Odziedziczone po TraceListener)
Write(Object, String)

Zapisuje nazwę kategorii i wartość ToString() metody obiektu do odbiornika tworzonego podczas implementowania TraceListener klasy.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Odziedziczone po TraceListener)
Write(String)

Zapisuje komunikat w pliku dziennika bez udostępniania dodatkowych informacji kontekstowych.Writes a message to the log file without providing any additional context information.

Write(String, String)

Zapisuje nazwę kategorii i komunikat do odbiornika tworzonego podczas implementowania TraceListener klasy.Writes a category name and a message to the listener you create when you implement the TraceListener class.

(Odziedziczone po TraceListener)
WriteIndent()

Zapisuje wcięcie do odbiornika tworzonego podczas implementowania tej klasy i resetuje NeedIndent Właściwość na false .Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

(Odziedziczone po TraceListener)
WriteLine(Object)

Zapisuje wartość ToString() metody obiektu do odbiornika tworzonego podczas implementowania TraceListener klasy, po której następuje terminator wiersza.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.

(Odziedziczone po TraceListener)
WriteLine(Object, String)

Zapisuje nazwę kategorii i wartość ToString() metody obiektu do odbiornika tworzonego podczas implementowania TraceListener klasy, po której następuje terminator wiersza.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.

(Odziedziczone po TraceListener)
WriteLine(String)

Zapisuje komunikat, a następnie bieżący terminator wiersza do pliku dziennika bez udostępniania dodatkowych informacji kontekstowych.Writes a message followed by the current line terminator to the log file without providing any additional context information.

WriteLine(String, String)

Zapisuje nazwę kategorii i komunikat do odbiornika tworzonego podczas implementowania TraceListener klasy, po którym następuje terminator wiersza.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Odziedziczone po TraceListener)

Dotyczy