HttpResponse.ClientDisconnectedToken Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web
Zestaw:
System.Web.dll

Pobiera obiekt, który jest potknięty CancellationToken po rozłączeniu klienta.

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

Wartość właściwości

CancellationToken

Token anulowania.

Uwagi

Ten interfejs API jest bezpieczny wątkowo. Istnieją jednak pewne ograniczenia dotyczące sposobu użycia tokenu anulowania. Użycie go niepoprawnie może prowadzić do warunków wyścigu, zakleszczeń lub innego nieoczekiwanego zachowania. Należy pamiętać o następujących wytycznych:

  • Upewnij się, że nie wywołasz tego interfejsu API poza granicami pojedynczego żądania, ponieważ ASP.NET usunie token anulowania na końcu żądania. Nie ma gwarancji, że token kiedykolwiek przejdzie do stanu anulowanego przed jego usunięciem. Jeśli na przykład żądanie zakończy się bez rozłączenia klienta, token zostanie usunięty bez uprzedniego anulowania.

  • Nie czekaj na metodę CancellationToken.WaitHandle, ponieważ powoduje to porażkę celu asynchronicznego powiadomienia i może powodować zakleszczenia.

  • Nie należy wywoływać CancellationToken.Register przeciążeń, które wywołują wywołanie zwrotne oryginalnego SynchronizationContext obiektu.

  • Nie należy używać HttpContext obiektu ani innych niewątkowych obiektów wewnętrznych ASP.NET z poziomu wywołania zwrotnego dostarczonego CancellationToken.Register do metody . Wywołanie zwrotne może być uruchomione współbieżnie z innymi ASP.NET lub kodem aplikacji.

  • Zachowaj metody wywołania zwrotnego z krótkim działaniem i nieblokują.

  • Staraj się unikać zgłaszania wyjątków z metod wywołania zwrotnego.

Ta właściwość jest obsługiwana tylko w usłudze Internet Information Service (IIS) 7.5 lub nowszej w trybie zintegrowanym. Jeśli wywołasz ją bez odpowiedniej wersji usług IIS lub trybu potoku, PlatformNotSupportedException zostanie zgłoszony błąd. Aby określić wersję usług IIS, użyj polecenia IISVersion. Aby określić tryb potoku, użyj polecenia UsingIntegratedPipeline.

Dotyczy