TraceSource Konstruktory

Definicja

Przestrzeń nazw:
System.Diagnostics
Zestaw:
System.dll
Zestaw:
netstandard.dll

Inicjuje nowe wystąpienie klasy TraceSource.

Przeciążenia

Nazwa Opis
TraceSource(String)

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

Inicjuje nowe wystąpienie TraceSource 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)

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

Parametr name ma wartość 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 dla klasy TraceSource.

// 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 jako nazwy źródłowej.

Note

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

Dotyczy

TraceSource(String, SourceLevels)

Inicjuje nowe wystąpienie TraceSource 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

Parametr name ma wartość null.

ArgumentException

name jest pustym ciągiem ("").

Uwagi

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

Note

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

Dotyczy