DiagnosticSource.OnActivityExport(Activity, Object) Metod

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 -> unit

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

Parametrar

Kommentarer

Om en instrumentationsplats finns på en plats där aktiviteter lämnar processen (till exempel utgående HTTP-begäranden) vill webbplatsen överföra tillstånd från aktiviteten till den utgående begäran.

I den mån det är möjligt bör detta göras av instrumentationsplatsen, eftersom det finns ett avtal mellan en Activity och den ougoing begärandelogik på instrumentationsplatsen. Instrumentationsplatsen kan dock inte hantera principer (till exempel om aktivitetsinformation ska inaktiveras eller skrivas i ett äldre format av kompatibilitetsskäl). För detta måste instrumentationsplatsen anropa tillbaka till loggningssystemet och be den att lösa principen. Det här är syftet med OnActivityExport metoden.

Metoden OnActivityExport ges Activity samt ett nyttolastobjekt som representerar den utgående begäran. En DiagnosticSource prenumerant har sedan möjlighet att uppdatera den utgående begäran innan den skickas.

Observera att den här metoden sällan används på instrumenteringsplatser (endast de platser som ligger på en utgående gräns för processen). Dessutom är den standardprincip som instrumentationsplatsen utför (till exempel att överföra alla aktivitetstillstånd i en viss utgående konvention) sannolikt bra. Den här metoden är bara för fall där det är ett problem. Den här metoden bör därför användas mycket sällan och är främst här för symetri med OnActivityImport och framtidssäkrande.

Observera att payload skrivs som en Object här, men alla särskilda instrumentationswebbplatser och prenumeranter bör känna till typen av nyttolast och därmed kasta och avkoda den om det behövs.