DiagnosticSource.OnActivityExport(Activity, Object) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Trasferisce lo stato da un'attività a un evento o operazione, come una richiesta HTTP, che si verificherà esternamente al processo.
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)Parametri
- activity
- Activity
Attività interessata da un evento esterno.
- payload
- Object
Oggetto che rappresenta la richiesta in uscita.
Commenti
Se un sito di strumentazione si trova in una posizione in cui le attività lasciano il processo (ad esempio le richieste HTTP in uscita), il sito vuole trasferire lo stato dall'attività alla richiesta in uscita.
Per quanto possibile, questa operazione deve essere eseguita dal sito di strumentazione, perché esiste un contratto tra un oggetto Activity e la logica di richiesta ougoing nel sito di strumentazione. Tuttavia, il sito di strumentazione non può gestire i criteri, ad esempio se le informazioni sulle attività devono essere disabilitate o scritte in un formato precedente per motivi di compatibilità.
Per questo motivo, il sito di strumentazione deve richiamare il sistema di registrazione e chiedere di risolvere i criteri. Questo è lo scopo del OnActivityExport metodo .
Al OnActivityExport metodo viene assegnato Activity e un oggetto payload che rappresenta la richiesta in uscita. Un DiagnosticSource sottoscrittore ha quindi la possibilità di aggiornare la richiesta in uscita prima dell'invio.
Si noti che questo metodo viene usato raramente nei siti di strumentazione (solo i siti che si trovano in un limite in uscita del processo). Inoltre, è probabile che il criterio predefinito eseguito dal sito di strumentazione (ad esempio, per trasferire tutto lo stato di attività in una determinata convenzione in uscita) sia corretto. Questo metodo è solo per i casi in cui si tratta di un problema. Pertanto, questo metodo deve essere usato molto raramente ed è principalmente qui per la symetry con OnActivityImport e la correzione futura.
Si noti che payload è tipizzato come Object qui, ma qualsiasi sito di strumentazione e sottoscrittore specifico deve conoscere il tipo del payload e quindi eseguire il cast e decodificarlo, se necessario.
