Українська · Русский · 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 代碼立即終止。