DiagnosticSource.OnActivityExport(Activity, Object) 方法

定義

將狀態從活動傳輸給一些會在處理序外部發生的範圍或作業 (例如傳出的 HTTP 要求)。

C#
public virtual void OnActivityExport (System.Diagnostics.Activity activity, object? payload);
C#
public virtual void OnActivityExport (System.Diagnostics.Activity activity, object payload);

參數

activity
Activity

受外部事件影響的活動。

payload
Object

表示傳出要求的物件。

備註

如果檢測月臺位於活動離開進程 (的位置,例如傳出 HTTP 要求) ,該月臺會想要將狀態從活動傳送至傳出要求。

在可能的情況下,這應該由檢測月臺完成,因為 檢測站臺上的 與 Activity ougoing 要求邏輯之間有合約。 不過,檢測網站無法處理原則 (,例如,基於相容性原因,是否應該停用或以較舊的格式寫入活動資訊) 。 因此,檢測月台必須回呼記錄系統,並要求它解決原則。 這是方法的 OnActivityExport 用途。

方法 OnActivityExport 會提供 , Activity 以及代表傳出要求的承載物件。 DiagnosticSource訂閱者接著能夠先更新傳出要求,再傳送。

請注意,這個方法很少用於檢測月臺, (只有進程) 的傳出界限上的月臺。 此外,檢測月臺執行的默認原則通常會 (,以在特定傳出慣例中傳送所有活動狀態,) 可能沒問題。 這個方法僅適用於發生問題的情況。 因此,這個方法應該非常罕見地使用,而且大部分用於搭配 OnActivityImport 和未來校訂的 symetry。

請注意, payload 此處的類型為 Object ,但任何特定的檢測網站和訂閱者都應該知道承載的類型,因此視需要轉換和譯碼。

適用於

產品 版本
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9