HttpResponse.ClientDisconnectedToken 屬性

定義

命名空間:

System.Web

組件:

System.Web.dll

取得用戶端中斷連接時發生錯誤的 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 。