DiagnosticSource.OnActivityExport(Activity, Object) Metodo

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.DiagnosticSource.dll

Origine:

DiagnosticSourceActivity.cs

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);

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), 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.