CancellationTokenSource.Cancel Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Comunica uma solicitação de cancelamento.
Sobrecargas
| Nome | Description |
|---|---|
| Cancel() |
Comunica uma solicitação de cancelamento. |
| Cancel(Boolean) |
Comunica uma solicitação de cancelamento e especifica se os retornos de chamada restantes e as operações canceláveis devem ser processados se ocorrer uma exceção. |
Cancel()
- Origem:
- CancellationTokenSource.cs
- Origem:
- CancellationTokenSource.cs
- Origem:
- CancellationTokenSource.cs
- Origem:
- CancellationTokenSource.cs
- Origem:
- CancellationTokenSource.cs
Comunica uma solicitação de cancelamento.
public:
void Cancel();public void Cancel();member this.Cancel : unit -> unitPublic Sub Cancel ()Exceções
Isso CancellationTokenSource foi descartado.
Uma exceção agregada que contém todas as exceções geradas pelos retornos de chamada registrados no associado CancellationToken.
Exemplos
O exemplo a seguir usa um gerador de número aleatório para emular um aplicativo de coleta de dados que lê 10 valores integrais de onze instrumentos diferentes. Um valor zero indica que a medida falhou em um instrumento, caso em que a operação deve ser cancelada e nenhuma média geral deve ser computada.
Para lidar com o possível cancelamento da operação, o exemplo cria uma instância de um CancellationTokenSource objeto que gera um token de cancelamento que é passado para um TaskFactory objeto. O TaskFactory objeto, por sua vez, passa o token de cancelamento para cada uma das tarefas responsáveis por coletar leituras para um determinado instrumento. O TaskFactory.ContinueWhenAll<TAntecedentResult,TResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>[],TResult>, CancellationToken) método é chamado para garantir que a média seja computada somente depois que todas as leituras tiverem sido coletadas com êxito. Se uma tarefa não tiver sido cancelada, a chamada para o TaskFactory.ContinueWhenAll método gerará uma exceção.
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
public class Example
{
public static void Main()
{
// Define the cancellation token.
CancellationTokenSource source = new CancellationTokenSource();
CancellationToken token = source.Token;
Random rnd = new Random();
Object lockObj = new Object();
List<Task<int[]>> tasks = new List<Task<int[]>>();
TaskFactory factory = new TaskFactory(token);
for (int taskCtr = 0; taskCtr <= 10; taskCtr++) {
int iteration = taskCtr + 1;
tasks.Add(factory.StartNew( () => {
int value;
int[] values = new int[10];
for (int ctr = 1; ctr <= 10; ctr++) {
lock (lockObj) {
value = rnd.Next(0,101);
}
if (value == 0) {
source.Cancel();
Console.WriteLine("Cancelling at task {0}", iteration);
break;
}
values[ctr-1] = value;
}
return values;
}, token));
}
try {
Task<double> fTask = factory.ContinueWhenAll(tasks.ToArray(),
(results) => {
Console.WriteLine("Calculating overall mean...");
long sum = 0;
int n = 0;
foreach (var t in results) {
foreach (var r in t.Result) {
sum += r;
n++;
}
}
return sum/(double) n;
} , token);
Console.WriteLine("The mean is {0}.", fTask.Result);
}
catch (AggregateException ae) {
foreach (Exception e in ae.InnerExceptions) {
if (e is TaskCanceledException)
Console.WriteLine("Unable to compute mean: {0}",
((TaskCanceledException) e).Message);
else
Console.WriteLine("Exception: " + e.GetType().Name);
}
}
finally {
source.Dispose();
}
}
}
// Repeated execution of the example produces output like the following:
// Cancelling at task 5
// Unable to compute mean: A task was canceled.
//
// Cancelling at task 10
// Unable to compute mean: A task was canceled.
//
// Calculating overall mean...
// The mean is 5.29545454545455.
//
// Cancelling at task 4
// Unable to compute mean: A task was canceled.
//
// Cancelling at task 5
// Unable to compute mean: A task was canceled.
//
// Cancelling at task 6
// Unable to compute mean: A task was canceled.
//
// Calculating overall mean...
// The mean is 4.97363636363636.
//
// Cancelling at task 4
// Unable to compute mean: A task was canceled.
//
// Cancelling at task 5
// Unable to compute mean: A task was canceled.
//
// Cancelling at task 4
// Unable to compute mean: A task was canceled.
//
// Calculating overall mean...
// The mean is 4.86545454545455.
Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks
Module Example
Public Sub Main()
' Define the cancellation token.
Dim source As New CancellationTokenSource()
Dim token As CancellationToken = source.Token
Dim lockObj As New Object()
Dim rnd As New Random
Dim tasks As New List(Of Task(Of Integer()))
Dim factory As New TaskFactory(token)
For taskCtr As Integer = 0 To 10
Dim iteration As Integer = taskCtr + 1
tasks.Add(factory.StartNew(Function()
Dim value, values(9) As Integer
For ctr As Integer = 1 To 10
SyncLock lockObj
value = rnd.Next(0,101)
End SyncLock
If value = 0 Then
source.Cancel
Console.WriteLine("Cancelling at task {0}", iteration)
Exit For
End If
values(ctr-1) = value
Next
Return values
End Function, token))
Next
Try
Dim fTask As Task(Of Double) = factory.ContinueWhenAll(tasks.ToArray(),
Function(results)
Console.WriteLine("Calculating overall mean...")
Dim sum As Long
Dim n As Integer
For Each t In results
For Each r In t.Result
sum += r
n+= 1
Next
Next
Return sum/n
End Function, token)
Console.WriteLine("The mean is {0}.", fTask.Result)
Catch ae As AggregateException
For Each e In ae.InnerExceptions
If TypeOf e Is TaskCanceledException
Console.WriteLine("Unable to compute mean: {0}",
CType(e, TaskCanceledException).Message)
Else
Console.WriteLine("Exception: " + e.GetType().Name)
End If
Next
Finally
source.Dispose()
End Try
End Sub
End Module
' Repeated execution of the example produces output like the following:
' Cancelling at task 5
' Unable to compute mean: A task was canceled.
'
' Cancelling at task 10
' Unable to compute mean: A task was canceled.
'
' Calculating overall mean...
' The mean is 5.29545454545455.
'
' Cancelling at task 4
' Unable to compute mean: A task was canceled.
'
' Cancelling at task 5
' Unable to compute mean: A task was canceled.
'
' Cancelling at task 6
' Unable to compute mean: A task was canceled.
'
' Calculating overall mean...
' The mean is 4.97363636363636.
'
' Cancelling at task 4
' Unable to compute mean: A task was canceled.
'
' Cancelling at task 5
' Unable to compute mean: A task was canceled.
'
' Cancelling at task 4
' Unable to compute mean: A task was canceled.
'
' Calculating overall mean...
' The mean is 4.86545454545455.
Comentários
O associado CancellationToken é notificado sobre o cancelamento e faz a transição para um estado em que IsCancellationRequested retorna true.
Quaisquer retornos de chamada ou operações canceláveis registradas com eles CancellationToken serão executadas, se ainda não tiverem sido executadas por uma chamada anterior para Cancel(). As chamadas Cancel() subsequentes não executarão o mesmo retorno de chamada novamente, a menos que sejam reregisteradas. (Evite várias chamadas para Cancel(), porque a intenção desse código geralmente não está clara.)
Os retornos de chamada são executados de forma síncrona na ordem LIFO.
Recomendamos que operações canceláveis e retornos de chamada registrados sem CancellationToken gerar exceções.
Essa sobrecarga de Cancelar agrega todas as exceções lançadas em um AggregateException, de modo que um retorno de chamada que gera uma exceção não impedirá que outros retornos de chamada registrados sejam executados.
Chamar este método tem o mesmo efeito que chamar Cancel(false).
Confira também
Aplica-se a
Cancel(Boolean)
- Origem:
- CancellationTokenSource.cs
- Origem:
- CancellationTokenSource.cs
- Origem:
- CancellationTokenSource.cs
- Origem:
- CancellationTokenSource.cs
- Origem:
- CancellationTokenSource.cs
Comunica uma solicitação de cancelamento e especifica se os retornos de chamada restantes e as operações canceláveis devem ser processados se ocorrer uma exceção.
public:
void Cancel(bool throwOnFirstException);public void Cancel(bool throwOnFirstException);member this.Cancel : bool -> unitPublic Sub Cancel (throwOnFirstException As Boolean)Parâmetros
- throwOnFirstException
- Boolean
true se as exceções devem ser propagadas imediatamente; caso contrário, false.
Exceções
Isso CancellationTokenSource foi descartado.
Uma exceção agregada que contém todas as exceções geradas pelos retornos de chamada registrados no associado CancellationToken.
Comentários
O associado CancellationToken é notificado sobre o cancelamento e faz a transição para um estado em que IsCancellationRequested retorna true.
Quaisquer retornos de chamada ou operações canceláveis registradas com eles CancellationToken serão executadas, se ainda não tiverem sido executadas por uma chamada anterior para Cancel(). As chamadas Cancel() subsequentes não executarão o mesmo retorno de chamada novamente, a menos que sejam reregisteradas. (Evite várias chamadas para Cancel(), porque a intenção desse código geralmente não está clara.)
Os retornos de chamada são executados de forma síncrona na ordem LIFO.
Recomendamos que operações canceláveis e retornos de chamada registrados sem CancellationToken gerar exceções.
Se throwOnFirstException for true, uma exceção será propagada imediatamente para fora da chamada, Cancelimpedindo que os retornos de chamada restantes e as operações canceláveis sejam processados.
Se throwOnFirstException for false, essa sobrecarga agrega todas as exceções lançadas em um AggregateException, de modo que um retorno de chamada que gera uma exceção não impedirá que outros retornos de chamada registrados sejam executados.
