DiagnosticSource.OnActivityImport(Activity, Object) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de status overgedragen naar een activiteit van een bepaalde gebeurtenis of bewerking, zoals een binnenkomende aanvraag, die buiten het proces is opgetreden.
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 -> unitPublic Overridable Sub OnActivityImport (activity As Activity, payload As Object)Parameters
- activity
- Activity
De activiteit die wordt beïnvloed door een externe gebeurtenis.
- payload
- Object
Een nettolading die de binnenkomende aanvraag vertegenwoordigt.
Opmerkingen
Als een instrumentatiesite een nieuwe activiteit maakt als reactie op een bepaalde gebeurtenis buiten het proces, zoals een binnenkomende HTTP-aanvraag), kan die OnActivityImport site een nieuwe activiteit maken en de status van de binnenkomende aanvraag naar de activiteit overdragen.
Voor zover mogelijk moet dit worden gedaan door de instrumentatiesite, omdat er een contract is tussen de Activity en de binnenkomende aanvraaglogica op de instrumentatiesite. De instrumentatiesite kan echter geen beleid verwerken. (Als er bijvoorbeeld steekproeven worden genomen, moeten precies welke aanvragen worden genomen?) In dergelijke gevallen moet de instrumentatiesite terugbellen naar het logboekregistratiesysteem en het vragen om beleid op te lossen (bijvoorbeeld om te bepalen of de 'sampling'-bit van de activiteit moet worden ingesteld). Dit is het doel van de OnActivityImport methode. Het krijgt de activiteit en een nettoladingobject dat de binnenkomende aanvraag vertegenwoordigt. De abonnees van de DiagnosticSource gebruiker hebben de mogelijkheid om deze activiteit naar wens bij te werken.
Deze methode wordt zelden gebruikt op instrumentatiesites (alleen sites die zich op de grens van het proces bevinden) en de instrumetatiesite implementeert een bepaald standaardbeleid (het stelt de activiteit op een bepaalde manier in), en daarom is het niet nodig om deze methode te overschrijven als dat standaardbeleid prima is. Met andere woorden, deze methode moet worden overschreven in zeer zeldzame (maar vaak belangrijke) gevallen.
payload Zoals hier getyptObject, maar een bepaalde instrumentatiesite en abonnee weet het type van de nettolading en dus cast en decoderen indien nodig.
