Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

취소, 일시중지 및 백그라운드 스크립트

설명서 C# · 예시 UO

CancellationTokenSource는 취소 요청을 생성하고, CancellationToken는 작업에 전달됩니다. 취소는 협조적입니다. 작업에서 토큰을 확인하거나 전달합니다. 포함된 스크립트는 Cancellation를 얻습니다. WaitAsync는 대기에 사용됩니다.

간단한 예제 (Example.csx)

이 예제를 Example.csx로 따로 저장하고 이 페이지의 다른 예제와 독립적으로 실행하세요.

Example.csx:

Cancellation.ThrowIfCancellationRequested();
await WaitAsync(10);
UO.Print("Done");

취소는 협력 방식입니다. 토큰 확인과 WaitAsync는 Stop에 반응하지만 취소를 지원하지 않는 외부 코드는 계속 실행될 수 있습니다.

결과:

Done

for (int i = 0; i < 3; i++)
{
    Cancellation.ThrowIfCancellationRequested();
    await WaitAsync(100);
    UO.Print($"Tick {i}");
}

{
    using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(1));
    using var linked = CancellationTokenSource.CreateLinkedTokenSource(Cancellation, timeout.Token);
    try
    {
        await Task.Delay(10, linked.Token);
        UO.Print("Operation completed");
    }
    catch (OperationCanceledException) when (timeout.IsCancellationRequested)
    {
        UO.Print("Local timeout");
    }
}

스크립트 중지를 무한 차단 OperationCanceledException로 대체하지 마세요. 타사 라이브러리에 대한 임의 차단 ​​호출은 토큰이 있다고 해서 중단될 수 없습니다. 일시 중지와 취소 요청의 목적은 다릅니다. 일시 중지는 계속을 유지하고, 취소는 실행을 종료합니다.

공식 문서: 취소, 일시 중지 및 배경 스크립트 - Microsoft Learn.

취소 요청은 협조적입니다. Task.Delay Cancellation 전송 없이, 취소 지원 없이 타사 작업 및 라이브러리 호출 대기는 Stop를 누른 후 계속할 수 있습니다. 취소 요청이 이루어지면 해당 실행에 대한 추가 게임 활동이 금지됩니다. 이는 .NET 코드가 즉시 종료되도록 강제하지 않습니다.