HttpResponse.ClientDisconnectedToken Proprietà

Definizione

Spazio dei nomi:
System.Web
Assembly:
System.Web.dll

Ottiene un CancellationToken oggetto che viene ritagliato quando il client si disconnette.

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

Valore della proprietà

CancellationToken

Token di annullamento.

Commenti

Questa API è thread-safe. Esistono tuttavia alcune restrizioni sul modo in cui deve essere usato il token di annullamento. L'uso non corretto può causare race condition, deadlock o altri comportamenti imprevisti. Tenere presenti le linee guida seguenti:

  • Assicurarsi di non chiamare questa API al di fuori dei limiti di una singola richiesta, perché ASP.NET eliminerà il token di annullamento alla fine della richiesta. Non esiste alcuna garanzia che il token passerà mai a uno stato annullato prima che venga eliminato. Ad esempio, se la richiesta termina senza che il client sia disconnesso, il token verrà eliminato senza essere stato annullato per la prima volta.

  • Non attendere su CancellationToken.WaitHandle, perché questo sconfigge lo scopo di una notifica asincrona e può causare deadlock.

  • Non chiamare gli CancellationToken.Register overload che richiamano il callback sull'oggetto originale SynchronizationContext .

  • Non usare l'oggetto o altri oggetti intrinseci non thread-safe ASP.NET dall'interno del callback fornito al metodo />

  • Mantenere i metodi di callback a esecuzione breve e non bloccante.

  • Eseguire ogni sforzo per evitare di generare eccezioni dall'interno dei metodi di callback.

Questa proprietà è supportata solo in Internet Information Service (IIS) 7.5 o versione successiva in modalità integrata. Se la si richiama senza la versione o la modalità pipeline IIS corretta, viene generata un'eccezione PlatformNotSupportedException . Per determinare la versione di IIS, usare IISVersion. Per determinare la modalità pipeline, usare UsingIntegratedPipeline.

Si applica a