HttpResponse.ClientDisconnectedToken Propriedade

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll

Obtém um CancellationToken objeto que desarma quando o cliente se desliga.

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

Valor de Propriedade

CancellationToken

O token de cancelamento.

Observações

Esta API é segura para threads. No entanto, existem algumas restrições sobre como o token de cancelamento deve ser utilizado. Usá-lo incorretamente pode levar a condições de corrida, impasses ou outros comportamentos inesperados. Tenha em mente as seguintes diretrizes:

  • Certifique-se de que não liga a esta API fora dos limites de um único pedido, porque o ASP.NET eliminará o token de cancelamento no final do pedido. Não há garantia de que o token alguma vez transite para um estado cancelado antes de ser descartado. Por exemplo, se o pedido terminar sem que o cliente tenha desligado, o token será eliminado sem ter sido cancelado primeiro.

  • Não espere pelo CancellationToken.WaitHandle, pois isso anula o propósito de uma notificação assíncrona e pode causar bloqueios.

  • Não chame as CancellationToken.Register sobrecargas que invocam o callback no objeto original SynchronizationContext .

  • Não use o objeto HttpContext nem outros objetos intrínsecos ASP.NET não seguros para threads dentro do callback fornecido ao método CancellationToken.Register. O callback pode estar a correr em simultâneo com outro código ASP.NET ou de aplicação.

  • Mantenha os métodos de callback curto e não bloqueadores.

  • Faça todos os esforços para evitar lançar exceções dentro dos métodos de callback.

Esta propriedade é suportada apenas no Internet Information Service (IIS) 7.5 ou superior em modo integrado. Se o invocar sem a versão IIS correta ou o modo pipeline, um PlatformNotSupportedException é lançado. Para determinar a versão IIS, use IISVersion. Para determinar o modo pipeline, use UsingIntegratedPipeline.

Aplica-se a