共用方式為


HttpResponse.ClientDisconnectedToken 屬性

定義

取得用戶端中斷連接時發生錯誤的 CancellationToken 物件。

public:
 property System::Threading::CancellationToken ClientDisconnectedToken { System::Threading::CancellationToken get(); };
public System.Threading.CancellationToken ClientDisconnectedToken { get; }
member this.ClientDisconnectedToken : System.Threading.CancellationToken
Public ReadOnly Property ClientDisconnectedToken As CancellationToken

屬性值

CancellationToken

取消語彙基元。

備註

此 API 是安全線程。 不過,使用取消權杖的方式有一些限制。 不正確地使用它可能會導致競爭狀況、死結或其他非預期的行為。 請記住下列指導方針:

  • 請確定您不會在單一要求界限外呼叫此 API,因為 ASP.NET 會在要求結束時處置取消權杖。 不保證權杖在處置之前會轉換至已取消的狀態。 例如,如果要求在沒有中斷連線的用戶端的情況下完成,則會處置權杖,而不需要先取消。

  • 請勿等候 CancellationToken.WaitHandle ,因為這會破壞非同步通知的目的,而且可能會導致死結。

  • 請勿呼叫在 CancellationToken.Register 原始 SynchronizationContext 物件上叫用回呼的多載。

  • 請勿在提供給 CancellationToken.Register 方法的回呼內,使用 HttpContext 物件或其他非執行緒安全 ASP.NET 內建物件。 回呼可能會與其他 ASP.NET 或應用程式程式碼同時執行。

  • 讓回呼方法保持短期執行和非封鎖。

  • 請盡一切努力避免在回呼方法內擲回例外狀況。

只有在整合模式中,Internet Information Service (IIS) 7.5 或更高版本才支援此屬性。 如果您在沒有正確的 IIS 版本或管線模式的情況下叫用它, PlatformNotSupportedException 則會擲回 。 若要判斷 IIS 版本,請使用 IISVersion 。 若要判斷管線模式,請使用 UsingIntegratedPipeline

適用於