C# Academy · Aula

Limites de tempo, IProgress<T>, descartáveis assíncronos (emulação)

Aplique limites de tempo com CancelAfter ou baseados em Task.WhenAny, conecte IProgress para atualizações adequadas à interface e use try/finally para emular a limpeza assíncrona no C# 6.

Aula 2 de 38 etapas

Limites de tempo, IProgress<T>, descartáveis assíncronos (emulação) é uma aula grátis de C# Academy no CoddyKit. Esta é a aula 2 de 3. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de C# Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de C# Academy inclui 3 aulas no total.

Plano

Objetivo:

  • Definir um tempo limite com CancelAfter
  • Definir um tempo limite por meio de Task.WhenAny
  • Relatar o progresso com IProgress<T>
  • Usar o padrão de limpeza async no C# 6 (try/finally)

Tempo limite com CancelAfter

Use CancelAfter e passe o token para a API async; o método chamado para cooperativamente quando o tempo limite é atingido.

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

public class Program
{
  static async Task<string> SlowOpAsync(CancellationToken ct)
  {
    // Simulate slow I/O that honors cancellation
    await Task.Delay(500, ct);
    return "OK";
  }

  public static void Main(string[] args)
  {
    var cts = new CancellationTokenSource();
    cts.CancelAfter(150); // timeout after 150 ms

    Task<string> t = SlowOpAsync(cts.Token);
    try
    {
      string result = t.GetAwaiter().GetResult(); // demo only
      Console.WriteLine(result);
    }
    catch (OperationCanceledException)
    {
      Console.WriteLine("Timed out");
    }
  }
}

Tempo limite com WhenAny

Task.WhenAny coloca o trabalho em disputa com Task.Delay; se o atraso vencer, lance uma TimeoutException.

using System;
using System.Threading.Tasks;

public class Program
{
  // Wrap any Task<T> with a timeout using WhenAny
  static async Task<T> WithTimeoutAsync<T>(Task<T> work, int milliseconds)
  {
    Task delay = Task.Delay(milliseconds);
    Task first = await Task.WhenAny(work, delay);
    if (first == work) return await work; // completed in time
    throw new TimeoutException("Operation timed out");
  }

  static async Task<int> ComputeAsync()
  {
    await Task.Delay(300); // pretend work
    return 7;
  }

  public static void Main(string[] args)
  {
    try
    {
      int v = WithTimeoutAsync(ComputeAsync(), 100).GetAwaiter().GetResult();
      Console.WriteLine("Value " + v);
    }
    catch (TimeoutException ex)
    {
      Console.WriteLine(ex.Message);
    }
  }
}

Demonstração de IProgress<T>

IProgress<T> desacopla o trabalho da interface do usuário; os produtores chamam Report, e os consumidores atualizam a interface ou a thread com segurança.

using System;
using System.Threading.Tasks;

public class Program
{
  static async Task DownloadAsync(IProgress<int> progress)
  {
    // Report 0..100 in steps; UI would receive ProgressChanged on its context
    for (int p = 0; p <= 100; p += 25)
    {
      await Task.Delay(60);
      if (progress != null) progress.Report(p);
    }
  }

  public static void Main(string[] args)
  {
    Progress<int> prog = new Progress<int>(percent =>
    {
      Console.WriteLine("Progress: " + percent + "%");
    });

    DownloadAsync(prog).GetAwaiter().GetResult();
  }
}

Padrão de limpeza async

O C# 6 não tem IAsyncDisposable; use try/finally e faça a liberação em finally depois que o trabalho aguardado for concluído.

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

public class Program
{
  static async Task WriteThenCloseAsync(string path)
  {
    // C# 6 has no IAsyncDisposable; emulate with try/finally.
    FileStream fs = null;
    StreamWriter sw = null;
    try
    {
      fs = new FileStream(path, FileMode.Create, FileAccess.Write, FileShare.None);
      sw = new StreamWriter(fs);
      await sw.WriteAsync("hello"); // do async work
      await sw.FlushAsync();        // ensure data is flushed
    }
    finally
    {
      // Dispose synchronously in finally
      if (sw != null) sw.Dispose();
      else if (fs != null) fs.Dispose();
    }
  }

  public static void Main(string[] args)
  {
    WriteThenCloseAsync("out.txt").GetAwaiter().GetResult();
    Console.WriteLine("Written");
  }
}

Boas práticas

Dicas:

  • Prefira CancelAfter para tempos limite simples de operações.
  • Use WhenAny para fluxos de tempo limite personalizados.
  • Mantenha os tipos de progresso pequenos (por exemplo, um int de porcentagem ou uma struct simples).
  • Sempre conclua as esperas antes de liberar os recursos; coloque a liberação em finally.

Padrão de tempo limite

Verificação rápida: Qual é uma forma simples de adicionar um tempo limite a uma operação async no C# 6 sem bloquear?

Resumo

Resumo: Implemente tempos limite com CancelAfter ou WhenAny, relate o progresso por meio de IProgress<T> e simule a liberação async com try/finally no C# 6.

Grátis para começar

Aprenda C# com um tutor de IA — grátis

Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.

Cursos
93
Aulas
346

Perguntas Frequentes

A aula “Limites de tempo, IProgress<T>, descartáveis assíncronos (emulação)” é grátis?

Sim — o texto completo de “Limites de tempo, IProgress<T>, descartáveis assíncronos (emulação)” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de C# Academy, atualize para CoddyKit PRO. O curso de C# Academy inclui 3 aulas no total.

O que vou aprender em “Limites de tempo, IProgress<T>, descartáveis assíncronos (emulação)”?

Aplique limites de tempo com CancelAfter ou baseados em Task.WhenAny, conecte IProgress para atualizações adequadas à interface e use try/finally para emular a limpeza assíncrona no C# 6. Você pratica C# Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar C# Academy?

Nenhuma experiência prévia é necessária. C# Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 3.

Quanto tempo leva a aula “Limites de tempo, IProgress<T>, descartáveis assíncronos (emulação)”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de C# Academy?

Sim. Cada aula de C# Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Padrões de CancellationToken; cancelamento cooperativo
  2. Limites de tempo, IProgress , descartáveis assíncronos (emulação)
  3. Fundamentos de resiliência: novas tentativas e recuo
← Voltar para C# Academy