DiagnosticSource.Write Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.DiagnosticSource.dll

Überlädt

Write(String, Object)	Stellt eine generische Möglichkeit zum Protokollieren komplexer Nutzlasten zur Verfügung.
Write<T>(String, T)

Write(String, Object)

Quelle:

DiagnosticSource.cs

Stellt eine generische Möglichkeit zum Protokollieren komplexer Nutzlasten zur Verfügung.

public:
 abstract void Write(System::String ^ name, System::Object ^ value);

public abstract void Write (string name, object? value);

abstract member Write : string * obj -> unit

Public MustOverride Sub Write (name As String, value As Object)

Parameter

name

String

Der Name des geschriebenen Ereignisses.

value

Object

Ein Objekt, das den Wert darstellt, der als Nutzlast für das Ereignis übergeben wird. Dies ist häufig ein anonymer Typ, der mehrere untergeordnete Werte enthält.

Hinweise

Jede Benachrichtigung erhält einen Namen, der sie identifiziert, sowie ein Objekt (in der Regel ein anonymer Typ), das beliebige Informationen bereitstellt, die an die Benachrichtigung übergeben werden.

name sollte kurz sein. Verwenden Sie keinen vollqualifizierten Namen, es sei denn, Sie müssen Mehrdeutigkeiten vermeiden, da name sie global eindeutig sein müssen. In der Regel stellt componentName.eventName, wobei componentName und eventName Zeichenfolgen sind, die weniger als 10 Zeichen sind, eine gute Kompromittierung dar.

Benachrichtigungsnamen sollten nicht . enthalten sein, da Komponentennamen Punkte aufweisen, und wenn beide Punkte enthalten, führt dies zu Mehrdeutigkeit. Es wird empfohlen, stattdessen zu verwenden _ .

Angenommen, Listener verwenden Zeichenfolgenpräfixe, um Gruppen zu filtern. Daher empfiehlt es sich, eine Hierarchie von Komponentennamen zu haben.

Write<T>(String, T)

Quelle:

DiagnosticSource.cs

public:
generic <typename T>
 void Write(System::String ^ name, T value);

public void Write<T> (string name, T value);

member this.Write : string * 'T -> unit

Public Sub Write(Of T) (name As String, value As T)

Typparameter

T

Parameter

name

String

value

T