Как правильно отменить выполнение Task в C#?

Ну что за дичь, опять эти токены отмены! Слушай, я тебе сейчас на пальцах объясню, как эту хрень использовать, чтобы не выстрелить себе в ногу.

Вот смотри, в C# тебе не дадут просто так взять и убить задачу — это не какой-то там варварский Thread.Abort(), который всё ломает к чертям. Тут всё по-взрослому, через вежливые уведомления. Есть два главных героя: CancellationTokenSource (тот, кто кричит "отмена!") и сам CancellationToken (флажок, который ты передаёшь в задачу).

1. Базовый сценарий, чтоб ты понял суть

// Это наш пульт управления отменой, с красной кнопкой
var cts = new CancellationTokenSource();
// А это сам флажок-уведомление, который мы будем тыкать в задачу
var token = cts.Token;

var task = Task.Run(() =>
{
    for (int i = 0; i < 1000; i++)
    {
        // Способ первый, радикальный: проверяем и сразу в исключение
        token.ThrowIfCancellationRequested(); // Если отмена запрошена — летит OperationCanceledException

        // Способ второй, аккуратный: проверили и вышли по-тихому
        if (token.IsCancellationRequested)
        {
            Console.WriteLine("Всё, приехали, завершаемся.");
            // Тут можно прибраться за собой — закрыть файлы, отключиться от БД
            return; // Просто выходим, задача будет считаться успешно завершённой
        }

        // Делаем вид, что работаем
        Thread.Sleep(100);
        Console.WriteLine($"Кручу-верчу, итерация {i}");
    }
}, token); // ОБЯЗАТЕЛЬНО суём токен сюда, это важно для правильного статуса задачи

// Допустим, прошло 2 секунды и нам надоело ждать
cts.CancelAfter(2000);
// Или можем отменить сразу: cts.Cancel();

try
{
    await task; // Если задача отменена через ThrowIfCancellationRequested, тут будет исключение
}
catch (OperationCanceledException)
{
    Console.WriteLine("Задачу отменили, как и просили.");
}

2. Таймаут — чтоб не ждать до второго пришествия

// Можно сразу создать источник с таймаутом
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
await SomeLongOperation(cts.Token);

// Или назначить таймаут потом
cts.CancelAfter(5000); // Через 5 секунд само отменится

3. Объединение токенов — когда на тебя орут сразу несколько

Бывает, что задача должна слушаться и пользователя (нажал "отмена"), и общего таймаута системы.

var userCts = new CancellationTokenSource(); // Пользовательская отмена
var timeoutCts = new CancellationTokenSource(TimeSpan.FromSeconds(30)); // Системный таймаут

// Связываем их вместе — сработает любой
using var linkedCts = CancellationTokenSource.CreateLinkedTokenSource(
    userCts.Token,
    timeoutCts.Token
);

await SuperImportantProcess(linkedCts.Token); // Передаём объединённый токен

4. Асинхронные операции — там всё уже готово

Все нормальные асинхронные методы в .NET (HttpClient, EF Core, файловые операции) принимают CancellationToken. Пользуйся!

public async Task<string> DownloadWithTimeout(string url, CancellationToken ct)
{
    using var httpClient = new HttpClient();
    // Передаём токен прямо в GetAsync — если отменят, запрос прервётся
    using var response = await httpClient.GetAsync(url, HttpCompletionOption.ResponseHeadersRead, ct);
    response.EnsureSuccessStatusCode();
    return await response.Content.ReadAsStringAsync(ct); // И здесь тоже!
}

// Используем
var cts = new CancellationTokenSource(TimeSpan.FromSeconds(10));
try
{
    var data = await DownloadWithTimeout("https://example.com", cts.Token);
}
catch (TaskCanceledException) // HttpClient кидает именно TaskCanceledException при отмене
{
    Console.WriteLine("Не успел, блядь, отменили по таймауту!");
}

5. Важный нюанс про состояние задачи

Запомни раз и навсегда:

• Если задача упала через ThrowIfCancellationRequested() — её статус будет TaskStatus.Canceled.
• Если она сама проверила IsCancellationRequested и вышла через return — статус TaskStatus.RanToCompletion (успех!).
• Задачу в состоянии Canceled или Faulted нельзя повторно awaitить — получишь исключение, как от скучной лекции.

И главный совет: всегда, блядь, проектируй свои долгие операции с возможностью отмены и прокидывай CancellationToken вглубь всех вызовов. Это признак хорошего тона, а не просто прихоть.