DiagnosticSource.OnActivityExport(Activity, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überträgt den Status einer Aktivität an ein bestimmtes Ereignis oder einen Vorgang, z. B. eine ausgehende HTTP-Anforderung, die außerhalb des Prozesses auftritt.
public:
virtual void OnActivityExport(System::Diagnostics::Activity ^ activity, System::Object ^ payload);public virtual void OnActivityExport(System.Diagnostics.Activity activity, object? payload);public virtual void OnActivityExport(System.Diagnostics.Activity activity, object payload);abstract member OnActivityExport : System.Diagnostics.Activity * obj -> unit
override this.OnActivityExport : System.Diagnostics.Activity * obj -> unitPublic Overridable Sub OnActivityExport (activity As Activity, payload As Object)Parameter
- activity
- Activity
Die aktivität, die von einem externen Ereignis betroffen ist.
- payload
- Object
Ein Objekt, das die ausgehende Anforderung darstellt.
Hinweise
Wenn sich eine Instrumentierungswebsite an einem Ort befindet, an dem Aktivitäten den Prozess verlassen (z. B. ausgehende HTTP-Anforderungen), möchte diese Website den Status von der Aktivität in die ausgehende Anforderung übertragen.
Soweit möglich, sollte dies vom Instrumentierungsstandort erfolgen, da es einen Vertrag zwischen einer Activity und der Ougoing-Anforderungslogik am Instrumentierungsstandort gibt. Die Instrumentierungswebsite kann jedoch keine Richtlinie verarbeiten (z. B. ob Aktivitätsinformationen deaktiviert oder aus Kompatibilitätsgründen in einem älteren Format geschrieben werden sollen).
Dazu muss die Instrumentierungswebsite den Rückruf an das Protokollierungssystem durchführen und sie auffordern, die Richtlinie zu beheben. Dies ist der Zweck der OnActivityExport Methode.
Die OnActivityExport Methode erhält sowohl das Activity Nutzlastobjekt, das die ausgehende Anforderung darstellt. Ein DiagnosticSource Abonnent hat dann die Möglichkeit, die ausgehende Anforderung zu aktualisieren, bevor sie gesendet wird.
Beachten Sie, dass diese Methode selten an Instrumentierungsstandorten verwendet wird (nur die Standorte, die sich an einer ausgehenden Grenze des Prozesses befinden). Darüber hinaus ist in der Regel die Standardrichtlinie, die der Instrumentierungsstandort ausführt (z. B. um den gesamten Aktivitätszustand in einer bestimmten ausgehenden Konvention zu übertragen) wahrscheinlich in Ordnung. Diese Methode gilt nur für Fälle, in denen dies ein Problem ist. Daher sollte diese Methode sehr selten verwendet werden und ist hauptsächlich für Symetrie mit OnActivityImport und zukunftssichern.
Beachten Sie, dass payload hier eingegeben Object wird, aber jeder bestimmte Instrumentierungsstandort und Abonnent sollte den Typ der Nutzlast kennen und es bei Bedarf umwandeln und decodieren.
