DiagnosticSource.OnActivityImport(Activity, Object) Metod

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)

Parametrar

Kommentarer

Om en instrumentationswebbplats skapar en ny aktivitet som svar på en händelse utanför processen, till exempel en inkommande HTTP-begäran, OnActivityImport tillåter metoden att webbplatsen vill skapa en ny aktivitet och överföra tillstånd från den inkommande begäran till aktiviteten.

I den mån det är möjligt bör detta göras av instrumentationsplatsen, eftersom det finns ett kontrakt mellan logiken Activity för inkommande begäran och på instrumentationsplatsen. Instrumentationsplatsen kan dock inte hantera principen. (Till exempel, om sampling görs, exakt vilka begäranden ska samplas?) I dessa fall måste instrumentationsplatsen anropa tillbaka till loggningssystemet och be den att lösa principen (till exempel för att avgöra om aktivitetens "samplingsbit" ska anges). Det här är syftet med OnActivityImport metoden. Den ges aktiviteten samt ett nyttolastobjekt som representerar den inkommande begäran. Prenumeranterna till DiagnosticSource då har möjlighet att uppdatera den här aktiviteten efter behov.

Den här metoden används sällan på instrumenteringsplatser (endast de platser som ligger på processens gräns) och instrumetationsplatsen implementerar någon standardprincip (den anger aktiviteten på något sätt), och därför är det inte nödvändigt att åsidosätta den här metoden om standardprincipen är bra. Med andra ord bör den här metoden åsidosättas i mycket sällsynta (men ofta viktiga) fall.

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