HttpResponse.ClientDisconnectedToken Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een CancellationToken object opgehaald dat wordt verschoven wanneer de client de verbinding verbreekt.
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
Waarde van eigenschap
Het annuleringstoken.
Opmerkingen
Deze API is thread-safe. Er zijn echter enkele beperkingen voor de wijze waarop het annuleringstoken moet worden gebruikt. Het onjuist gebruiken kan leiden tot raceomstandigheden, impasses of ander onverwacht gedrag. Houd rekening met de volgende richtlijnen:
Zorg ervoor dat u deze API niet buiten de grenzen van één aanvraag aanroept, omdat ASP.NET het annuleringstoken aan het einde van de aanvraag zal verwijderen. Er is geen garantie dat het token ooit wordt overgezet naar een geannuleerde status voordat het wordt verwijderd. Als de aanvraag bijvoorbeeld is voltooid zonder dat de client de verbinding heeft verbroken, wordt het token verwijderd zonder dat het eerst is geannuleerd.
Wacht niet op de CancellationToken.WaitHandle, omdat dit het doel van een asynchrone melding verslaat en impasses kan veroorzaken.
Roep de CancellationToken.Register overbelastingen die de callback op het oorspronkelijke SynchronizationContext object aanroepen niet aan.
Gebruik het HttpContext-object of andere niet-threadveilige ASP.NET intrinsieke objecten niet vanuit de callback die aan de methode CancellationToken.Register is verstrekt. De callback kan gelijktijdig worden uitgevoerd met andere ASP.NET of toepassingscode.
Houd de callback-methoden kortlopend en niet-blokkerend.
Zorg ervoor dat er geen uitzonderingen worden gegooid vanuit de callback-methoden.
Deze eigenschap wordt alleen ondersteund in IIS (Internet Information Service) 7.5 of hoger in de geïntegreerde modus. Als u deze aanroept zonder de juiste IIS-versie of pijplijnmodus, wordt er een PlatformNotSupportedException gegenereerd. Als u de IIS-versie wilt bepalen, gebruikt u IISVersion. Als u de pijplijnmodus wilt bepalen, gebruikt u UsingIntegratedPipeline.