0Pricing
C# Academy · Lección

Patrones de CancellationToken y cancelación cooperativa

Transmita y respete CancellationToken: cree un CTS, compruebe o lance excepciones al cancelar, páselo a APIs async y limpie los registros.

Patrones de CancellationToken y cancelación cooperativa es una lección gratuita de C# Academy en CoddyKit. Esta es la lección 1 de 3. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de C# Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de C# Academy incluye 3 lecciones en total.

Cancelación cooperativa

Objetivo: Cancelar el trabajo de forma cooperativa.

  • Crear un CancellationTokenSource
  • Pasar CancellationToken a las capas inferiores
  • Comprobar IsCancellationRequested o llamar a ThrowIfCancellationRequested()
  • Responder a la cancelación de forma rápida y limpia

Cancelación iniciada por el llamador

Crear un CancellationTokenSource, pasar el token y cancelar desde el llamador; el método llamado produce OperationCanceledException.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Program
{
  static async Task WorkAsync(CancellationToken ct)
  {
    // Poll occasionally; throw to end cooperatively
    for (int i = 0; i < 5; i++)
    {
      ct.ThrowIfCancellationRequested();
      Console.WriteLine("Step " + i);
      await Task.Delay(100, ct); // pass token to async API
    }
  }

  public static void Main(string[] args)
  {
    var cts = new CancellationTokenSource();
    Task t = WorkAsync(cts.Token);

    // Cancel after a short delay (simulated user action)
    Thread.Sleep(180);
    cts.Cancel();

    try
    {
      t.GetAwaiter().GetResult();
    }
    catch (OperationCanceledException)
    {
      Console.WriteLine("Canceled!");
    }
  }
}

Reenvío de tokens

Reenviar el token a través de cada capa asíncrona para que las llamadas internas puedan detenerse rápidamente.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Program
{
  static async Task<string> FetchAsync(CancellationToken ct)
  {
    await Task.Delay(80, ct); // pretend I/O
    ct.ThrowIfCancellationRequested();
    return "data";
  }

  static async Task<string> ProcessAsync(CancellationToken ct)
  {
    string raw = await FetchAsync(ct); // forward token
    await Task.Delay(80, ct);
    return raw.ToUpperInvariant();
  }

  public static void Main(string[] args)
  {
    var cts = new CancellationTokenSource();
    Task<string> job = ProcessAsync(cts.Token);
    cts.CancelAfter(100); // schedule a cancellation
    try
    {
      Console.WriteLine(job.GetAwaiter().GetResult());
    }
    catch (OperationCanceledException)
    {
      Console.WriteLine("Pipeline canceled");
    }
  }
}

Limpieza con token.Register

Usar token.Register para asociar una pequeña acción de limpieza que se ejecute cuando se solicite la cancelación.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Program
{
  static async Task UseRegistrationAsync(CancellationToken ct)
  {
    using (ct.Register(() => Console.WriteLine("Cleanup: releasing temp resources")))
    {
      for (int i = 0; i < 3; i++)
      {
        ct.ThrowIfCancellationRequested();
        await Task.Delay(120, ct);
        Console.WriteLine("Tick " + i);
      }
    }
  }

  public static void Main(string[] args)
  {
    var cts = new CancellationTokenSource();
    Task t = UseRegistrationAsync(cts.Token);
    Thread.Sleep(150);
    cts.Cancel();
    try { t.GetAwaiter().GetResult(); }
    catch (OperationCanceledException) { Console.WriteLine("Canceled with cleanup"); }
  }
}

Fuentes vinculadas

CreateLinkedTokenSource combina varias señales (por ejemplo, la cancelación del usuario y un tiempo de espera) en un único token.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Program
{
  static async Task WorkAsync(CancellationToken ct)
  {
    await Task.Delay(500, ct);
    Console.WriteLine("Finished work");
  }

  public static void Main(string[] args)
  {
    var parent = new CancellationTokenSource();
    var timeout = new CancellationTokenSource();
    timeout.CancelAfter(200);

    // Link both sources: cancel if parent OR timeout requests
    var linked = CancellationTokenSource.CreateLinkedTokenSource(parent.Token, timeout.Token);

    Task t = WorkAsync(linked.Token);
    try { t.GetAwaiter().GetResult(); }
    catch (OperationCanceledException) { Console.WriteLine("Canceled by parent/timeout"); }
    finally { linked.Dispose(); parent.Dispose(); timeout.Dispose(); }
  }
}

Prácticas recomendadas

Consejos:

  • Pasar los tokens a las API asíncronas (Task.Delay, E/S) para que se detengan rápidamente.
  • Lanzar OperationCanceledException para finalizar el trabajo; no ocultarla.
  • Eliminar CancellationTokenSource si administra temporizadores o registros.
  • Mantener rápidos los controladores; realizar un trabajo mínimo en Register.

Regla de cancelación cooperativa

Comprobación rápida: ¿Cuál es la forma correcta de que un método responda a una solicitud de cancelación?

Resumen

Resumen: Hacer que la cancelación sea cooperativa: pasar tokens, comprobar periódicamente o llamar a ThrowIfCancellationRequested, asociar una pequeña acción de limpieza y vincular fuentes para combinar señales.

Preguntas frecuentes

¿La lección «Patrones de CancellationToken y cancelación cooperativa» es gratis?

Sí — el texto completo de «Patrones de CancellationToken y cancelación cooperativa» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de C# Academy, actualiza a CoddyKit PRO. El curso de C# Academy incluye 3 lecciones en total.

¿Qué aprenderé en «Patrones de CancellationToken y cancelación cooperativa»?

Transmita y respete CancellationToken: cree un CTS, compruebe o lance excepciones al cancelar, páselo a APIs async y limpie los registros. Practicas C# Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar C# Academy?

No se requiere experiencia previa. C# Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 3.

¿Cuánto tiempo toma la lección «Patrones de CancellationToken y cancelación cooperativa»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de C# Academy?

Sí. Cada lección de C# Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Patrones de CancellationToken y cancelación cooperativa
  2. Timeouts, IProgress y disposables async (emulación)
  3. Fundamentos de resiliencia: reintentos y backoff
← Volver a C# Academy