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 a un'operazione, ad esempio una richiesta HTTP in uscita, che si verificherà all'esterno del 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 -> unit
Public 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, tale sito vuole trasferire lo stato dall'attività alla richiesta in uscita.
Per quanto possibile, questa operazione deve essere eseguita dal sito di strumentazione, perché è presente un contratto tra un Activity oggetto e la logica di richiesta di 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 meno recente 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 nonché 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 symetria con OnActivityImport e la correzione futura.
Si noti che payload viene digitato come qui Object , ma qualsiasi sito di strumentazione e sottoscrittore specifico deve conoscere il tipo del payload e quindi eseguire il cast e decodificarlo, se necessario.