HttpResponse.ClientDisconnectedToken HttpResponse.ClientDisconnectedToken HttpResponse.ClientDisconnectedToken HttpResponse.ClientDisconnectedToken Property

Definition

Ruft ein CancellationToken-Objekt ab, das aktiviert wird, wenn der Client die Verbindung trennt.Gets a CancellationToken object that is tripped when the client disconnects.

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

Eigenschaftswert

Das Abbruchtoken.The cancellation token.

Hinweise

Diese API ist Thread sicher.This API is thread-safe. Es gibt jedoch einige Einschränkungen hinsichtlich der Verwendung des Abbruch Tokens.However, there are some restrictions on how the cancellation token should be used. Eine falsche Verwendung kann zu Racebedingungen, Deadlocks oder anderem unerwartetem Verhalten führen.Using it incorrectly can lead to race conditions, deadlocks, or other unexpected behavior. Beachten Sie die folgenden Richtlinien:Keep in mind the following guidelines:

  • Stellen Sie sicher, dass diese API nicht außerhalb der Grenzen einer einzelnen Anforderung aufgerufen wird, da ASP.NET das Abbruch Token am Ende der Anforderung löscht.Ensure that you don't call into this API outside the bounds of a single request, because ASP.NET will dispose of the cancellation token at the end of the request. Es gibt keine Garantie, dass das Token jemals in den Zustand "abgebrochen" übergeht, bevor es verworfen wird.There is no guarantee that the token will ever transition to a canceled state before it is disposed. Wenn die Anforderung z. b. beendet wird, ohne dass der Client getrennt wurde, wird das Token verworfen, ohne dass es zuerst abgebrochen wurde.For example, if the request finishes without the client having disconnected, the token will be disposed without having first been canceled.

  • Warten Sie nicht auf CancellationToken.WaitHandle, da dadurch der Zweck einer asynchronen Benachrichtigung und Deadlocks verursacht werden.Do not wait on the CancellationToken.WaitHandle, as this defeats the purpose of an asynchronous notification and can cause deadlocks.

  • Rufen Sie nicht die CancellationToken.Register über Ladungen auf, die den Rückruf für das SynchronizationContext ursprüngliche Objekt aufrufen.Do not call the CancellationToken.Register overloads which invoke the callback on the original SynchronizationContext object.

  • Verwenden Sie das HttpContext -Objekt oder andere nicht Thread sichere ASP.NET-Objekte nicht innerhalb des für die CancellationToken.Register -Methode bereitgestellten Rückrufs.Do not use the HttpContext object or other non-thread-safe ASP.NET intrinsic objects from within the callback provided to the CancellationToken.Register method. Der Rückruf kann gleichzeitig mit anderem ASP.net-oder Anwendungscode ausgeführt werden.The callback may be running concurrently with other ASP.NET or application code.

  • Halten Sie die Rückruf Methoden mit kurzer Laufzeit und ohne Blockierung.Keep the callback methods short-running and non-blocking.

  • Machen Sie alle Anstrengungen, um zu vermeiden, dass Ausnahmen innerhalb der Rückruf Methoden ausgelöst werden.Make every effort to avoid throwing exceptions from within the callback methods.

Diese Eigenschaft wird nur in Internet Informationsdienste (IIS) 7,5 oder höher im integrierten Modus unterstützt.This property is only supported in Internet Information Service (IIS) 7.5 or higher in integrated mode. Wenn Sie es ohne die richtige IIS-Version oder den richtigen Pipeline Modus PlatformNotSupportedException aufrufen, wird eine ausgelöst.If you invoke it without the right IIS version or pipeline mode, a PlatformNotSupportedException is thrown. Verwenden IISVersionSie zum Bestimmen der IIS-Version.To determine the IIS version, use IISVersion. Verwenden UsingIntegratedPipelineSie, um den Pipeline Modus zu bestimmen.To determine the pipeline mode, use UsingIntegratedPipeline.

Gilt für: