TraceSource Konstruktory

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.TraceSource.dll

Inicjuje nowe wystąpienie klasy TraceSource.

Przeciążenia

TraceSource(String)	Inicjuje TraceSource nowe wystąpienie klasy przy użyciu określonej nazwy dla źródła.
TraceSource(String, SourceLevels)	Inicjuje TraceSource nowe wystąpienie klasy przy użyciu określonej nazwy źródła i domyślnego poziomu źródła, na którym ma nastąpić śledzenie.

TraceSource(String)

Źródło:

TraceSource.cs

Inicjuje TraceSource nowe wystąpienie klasy przy użyciu określonej nazwy dla źródła.

public:
 TraceSource(System::String ^ name);

public TraceSource (string name);

new System.Diagnostics.TraceSource : string -> System.Diagnostics.TraceSource

Public Sub New (name As String)

Parametry

name

String

Nazwa źródła (zazwyczaj nazwa aplikacji).

Wyjątki

ArgumentNullException

name to null.

ArgumentException

name jest pustym ciągiem ("").

Przykłady

Poniższy przykład kodu przedstawia użycie konstruktora TraceSource do utworzenia nowego TraceSource obiektu. Ten przykład kodu jest częścią większego przykładu udostępnionego TraceSource dla klasy .

// Initialize the trace source.
static TraceSource ts = new TraceSource("TraceTest");

' Initialize the trace source.
Private Shared ts As New TraceSource("TraceTest")

Uwagi

Nazwa źródła służy do identyfikowania śladów. Jest on używany przez element w SourceFilter celu określenia, czy odbiornik śledzenia powinien wygenerować ślad. Zalecaną praktyką jest użycie nazwy aplikacji dla nazwy źródłowej.

Uwaga

Nie jest konieczne utworzenie nowego TraceSource wystąpienia dla każdego żądania śledzenia. Twórca jedno TraceSource wystąpienie i użyj go dla wszystkich żądań śledzenia aplikacji.

TraceSource(String, SourceLevels)

Źródło:

TraceSource.cs

Inicjuje TraceSource nowe wystąpienie klasy przy użyciu określonej nazwy źródła i domyślnego poziomu źródła, na którym ma nastąpić śledzenie.

public:
 TraceSource(System::String ^ name, System::Diagnostics::SourceLevels defaultLevel);

public TraceSource (string name, System.Diagnostics.SourceLevels defaultLevel);

new System.Diagnostics.TraceSource : string * System.Diagnostics.SourceLevels -> System.Diagnostics.TraceSource

Public Sub New (name As String, defaultLevel As SourceLevels)

Parametry

name

String

Nazwa źródła, zazwyczaj nazwa aplikacji.

defaultLevel

SourceLevels

Bitowa kombinacja wartości wyliczenia, która określa domyślny poziom źródła, na którym ma być śledzone.

Wyjątki

ArgumentNullException

name to null.

ArgumentException

name jest pustym ciągiem ("").

Uwagi

Nazwa źródła służy do identyfikowania śladów. Może być używany przez element w SourceSwitch celu określenia, czy ma nastąpić śledzenie, oraz przez element SourceFilter w celu określenia, czy należy wygenerować ślad. Domyślny poziom źródła jest używany przez element EventTypeFilter w celu określenia, czy śledzenie ma być wykonywane na podstawie poziomu źródłowego komunikatu do śledzenia.

Uwaga

Nie jest konieczne utworzenie nowego TraceSource wystąpienia dla każdego żądania śledzenia. Twórca jedno TraceSource wystąpienie i użyj go dla wszystkich żądań śledzenia aplikacji.