Registrace zpětných volání pro žádosti o zrušení
Zjistěte, jak zaregistrovat delegáta, který se vyvolá, když se vlastnost stane pravdivou IsCancellationRequested . Hodnota se změní z false na true, když se provede volání Cancel objektu, který vytvořil token. Tuto techniku použijte ke zrušení asynchronních operací, které nativně nepodporují sjednocenou architekturu zrušení, a pro odblokování metod, které můžou čekat na dokončení asynchronní operace.
Poznámka:
Pokud je povolená možnost Jen můj kód, sada Visual Studio se v některých případech přeruší na řádku, který vyvolá výjimku, a zobrazí chybovou zprávu"Výjimka, která není zpracována uživatelským kódem." Tato chyba je neškodná. Stisknutím klávesy F5 můžete pokračovat a zobrazit chování zpracování výjimek, které je znázorněno v následujících příkladech. Pokud chcete sadě Visual Studio zabránit v přerušení první chyby, zrušte zaškrtnutí políčka Jen můj kód v části Nástroje, Možnosti, Ladění, Obecné.
Příklad
V následujícím příkladu CancelAsync je metoda registrována jako metoda, která se má vyvolat při zrušení prostřednictvím tokenu zrušení.
using System;
using System.Net;
using System.Threading;
using System.Threading.Tasks;
class CancelWithCallback
{
static void Main()
{
using var cts = new CancellationTokenSource();
var token = cts.Token;
_ = Task.Run(async () =>
{
using var client = new WebClient();
client.DownloadStringCompleted += (_, args) =>
{
if (args.Cancelled)
{
Console.WriteLine("The download was canceled.");
}
else
{
Console.WriteLine("The download has completed:\n");
Console.WriteLine($"{args.Result}\n\nPress any key to continue.");
}
};
if (!token.IsCancellationRequested)
{
using CancellationTokenRegistration ctr = token.Register(() => client.CancelAsync());
Console.WriteLine("Starting request\n");
await client.DownloadStringTaskAsync(new Uri("http://www.contoso.com"));
}
}, token);
Console.WriteLine("Press 'c' to cancel.\n\n");
if (Console.ReadKey().KeyChar == 'c')
{
cts.Cancel();
}
Console.WriteLine("\nPress any key to exit.");
Console.ReadKey();
}
}
Imports System.Net
Imports System.Threading
Friend Class CancelWithCallback
Private Shared Sub Main()
Using cts = New CancellationTokenSource()
Dim token = cts.Token
Task.Run(
Async Function()
Using client As New WebClient()
AddHandler client.DownloadDataCompleted,
Sub(__, args)
If args.Cancelled Then
Console.WriteLine("The download was canceled.")
Else
Console.WriteLine($"The download has completed:{vbLf}")
Console.WriteLine($"{args.Result}{vbLf}{vbLf}Press any key to continue.")
End If
End Sub
If Not token.IsCancellationRequested Then
Dim ctr As CancellationTokenRegistration = token.Register(Sub() client.CancelAsync())
Console.WriteLine($"Starting request{vbLf}")
Await client.DownloadStringTaskAsync(New Uri("http://www.contoso.com"))
End If
End Using
End Function, token)
Console.WriteLine($"Press 'c' to cancel.{vbLf}{vbLf}")
If Console.ReadKey().KeyChar = "c"c Then
cts.Cancel()
End If
Console.WriteLine($"{vbLf}Press any key to exit.")
Console.ReadKey()
End Using
End Sub
End Class
Pokud již bylo při registraci zpětného volání požadováno zrušení, je stále zaručeno volání zpětného volání. V tomto konkrétním případě nebude metoda dělat nic, CancelAsync pokud neprobíhá žádná asynchronní operace, takže je vždy bezpečné volat metodu.
