DiagnosticSource.Write Methode

Definition

Überlädt

Name Beschreibung
Write(String, Object)

Stellt eine allgemeine Möglichkeit zum Protokollieren komplexer Nutzlasten bereit.

Write<T>(String, T)

Stellt eine allgemeine Möglichkeit zum Protokollieren komplexer Nutzlasten bereit.

Write(String, Object)

Quelle:
DiagnosticSource.cs
Quelle:
DiagnosticSource.cs
Quelle:
DiagnosticSource.cs
Quelle:
DiagnosticSource.cs
Quelle:
DiagnosticSource.cs
Quelle:
DiagnosticSource.cs
Quelle:
DiagnosticSource.cs

Stellt eine allgemeine Möglichkeit zum Protokollieren komplexer Nutzlasten bereit.

public:
 abstract void Write(System::String ^ name, System::Object ^ value);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type of object being written to DiagnosticSource cannot be discovered statically.")]
public abstract void Write(string name, object? value);
public abstract void Write(string name, object? value);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type of object being written to DiagnosticSource cannot be discovered statically.")]
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("DiagnosticSource may require creating new generic types or methods, which requires creating code at runtime. This may not work when AOT compiling.")]
public abstract void Write(string name, object? value);
public abstract void Write(string name, object value);
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type of object being written to DiagnosticSource cannot be discovered statically.")>]
abstract member Write : string * obj -> unit
abstract member Write : string * obj -> unit
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type of object being written to DiagnosticSource cannot be discovered statically.")>]
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("DiagnosticSource may require creating new generic types or methods, which requires creating code at runtime. This may not work when AOT compiling.")>]
abstract member Write : string * obj -> unit
Public MustOverride Sub Write (name As String, value As Object)

Parameter

name
String

Der Name des Ereignisses, das geschrieben wird.

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 Unterwerte enthält.

Attribute

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 Mehrdeutigkeit vermeiden, da name sie global eindeutig sein müssen. In der Regel sind componentName.eventName, wobei "componentName " und " eventName " Zeichenfolgen kleiner als 10 Zeichen sind, eine gute Kompromittierung.

Benachrichtigungsnamen sollten nicht . enthalten sein, da Komponentennamen Punkte enthalten, und für beide Punkte ergeben sich Mehrdeutigkeit. Es wird empfohlen, stattdessen zu verwenden _ .

Angenommen, Listener verwenden Zeichenfolgenpräfixe zum Filtern von Gruppen. Daher ist die Berücksichtigung einer Hierarchie von Komponentennamen eine bewährte Methode.

Gilt für:

Write<T>(String, T)

Quelle:
DiagnosticSource.cs
Quelle:
DiagnosticSource.cs
Quelle:
DiagnosticSource.cs
Quelle:
DiagnosticSource.cs
Quelle:
DiagnosticSource.cs
Quelle:
DiagnosticSource.cs

Stellt eine allgemeine Möglichkeit zum Protokollieren komplexer Nutzlasten bereit.

public:
generic <typename T>
 void Write(System::String ^ name, T value);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Only the properties of the T type will be preserved. Properties of referenced types and properties of derived types may be trimmed.")]
public void Write<T>(string name, T value);
public void Write<T>(string name, T value);
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Only the properties of the T type will be preserved. Properties of referenced types and properties of derived types may be trimmed.")>]
member this.Write : string * 'T -> unit
member this.Write : string * 'T -> unit
Public Sub Write(Of T) (name As String, value As T)

Typparameter

T

Der Typ des Werts, der als Nutzlast für das Ereignis übergeben wird.

Parameter

name
String

Der Name des Ereignisses, das geschrieben wird.

value
T

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

Attribute

Gilt für: