DiagnosticSource.OnActivityImport(Activity, Object) Methode

public:
 virtual void OnActivityImport(System::Diagnostics::Activity ^ activity, System::Object ^ payload);

public virtual void OnActivityImport(System.Diagnostics.Activity activity, object? payload);

public virtual void OnActivityImport(System.Diagnostics.Activity activity, object payload);

abstract member OnActivityImport : System.Diagnostics.Activity * obj -> unit
override this.OnActivityImport : System.Diagnostics.Activity * obj -> unit

Public Overridable Sub OnActivityImport (activity As Activity, payload As Object)

Parameter

Hinweise

Wenn eine Instrumentierungswebsite eine neue Aktivität als Reaktion auf ein Ereignis außerhalb des Prozesses erstellt, z. B. eine eingehende HTTP-Anforderung), ermöglicht die OnActivityImport Methode, dass diese Website eine neue Aktivität erstellen und den Status von der eingehenden Anforderung an die Aktivität übertragen möchte.

Soweit möglich, sollte dies vom Instrumentierungsstandort erfolgen, da es einen Vertrag zwischen der Activity und der Logik für eingehende Anforderungen an der Instrumentierungsstelle gibt. Die Instrumentierungswebsite kann jedoch keine Richtlinie verarbeiten. (Wenn die Stichprobe z. B. erfolgt, sollten genau welche Anforderungen abgesampt werden?) In diesen Fällen muss die Instrumentierungswebsite das Protokollierungssystem aufrufen und die Richtlinie auflösen (z. B. um zu entscheiden, ob das Bit "Sampling" der Aktivität festgelegt werden soll). Dies ist der Zweck der OnActivityImport Methode. Sie erhält die Aktivität sowie ein Nutzlastobjekt, das die eingehende Anforderung darstellt. Die Abonnenten haben DiagnosticSource dann die Möglichkeit, diese Aktivität nach Wunsch zu aktualisieren.

Diese Methode wird selten an Instrumentierungsstandorten verwendet (nur die Standorte, die sich an der Grenze des Prozesses befinden), und die Instrumetation-Site implementiert einige Standardrichtlinien (sie legt die Aktivität auf irgendeine Weise fest), und daher ist es nicht erforderlich, diese Methode außer Kraft zu setzen, wenn diese Standardrichtlinie einwandfrei ist. Mit anderen Worten, diese Methode sollte in sehr seltenen (aber häufig wichtigen) Fällen überschrieben werden.

Beachten Sie, dass payload sie wie Object hier eingegeben wird, aber jeder bestimmte Instrumentierungsstandort und Abonnent kennt den Typ der Nutzlast und wandelt sie bei Bedarf um und decodiert sie.