DiagnosticSource.OnActivityExport(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 van een activiteit overgedragen naar een bepaalde gebeurtenis of bewerking, zoals een uitgaande HTTP-aanvraag, die buiten het proces plaatsvindt.
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)
Parameters
- activity
- Activity
De activiteit die wordt beïnvloed door een externe gebeurtenis.
- payload
- Object
Een object dat de uitgaande aanvraag vertegenwoordigt.
Opmerkingen
Als een instrumentatiesite zich op een locatie bevindt waar activiteiten het proces verlaten (zoals uitgaande HTTP-aanvragen), wil die site de status overdragen van de activiteit naar de uitgaande aanvraag.
Voor zover mogelijk moet dit worden gedaan door de instrumentatiesite, omdat er een contract is tussen een Activity en de ougoing aanvraaglogica op de instrumentatiesite. De instrumentatiesite kan echter geen beleid verwerken (bijvoorbeeld of activiteitsgegevens moeten worden uitgeschakeld of in een oudere indeling moeten worden geschreven om compatibiliteitsredenen).
Hiervoor moet de instrumentatiesite terugbellen naar het logboekregistratiesysteem en het vragen om beleid op te lossen. Dit is het doel van de OnActivityExport methode.
De OnActivityExport methode krijgt het Activity en een nettoladingobject dat de uitgaande aanvraag vertegenwoordigt. Een DiagnosticSource abonnee kan de uitgaande aanvraag vervolgens bijwerken voordat deze wordt verzonden.
Houd er rekening mee dat deze methode zelden wordt gebruikt op instrumentatiesites (alleen sites die zich op een uitgaande grens van het proces bevinden). Bovendien is het standaardbeleid dat de instrumentatiesite uitvoert (bijvoorbeeld om alle activiteitsstatussen in een bepaalde uitgaande conventie over te dragen) waarschijnlijk prima. Deze methode is alleen bedoeld voor gevallen waarin dat een probleem is. Deze methode moet dus zeer zelden worden gebruikt en is meestal hier voor symetrie met OnActivityImport en toekomstbestendig.
Let op: payload dit is hier getypt Object , maar elke specifieke instrumentatiesite en abonnee moet het type van de nettolading kennen en zo nodig casten en decoderen.