JA CSharp Cancellation

Українська · Русский · 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。

キャンセルリクエストは協力的です。 Cancellation 転送なしの Task.Delay、キャンセルサポートなしでサードパーティのタスクとライブラリ呼び出しを待機している場合は、Stop を押した後も続行できます。キャンセル要求が行われると、その実行に関するさらなるゲーム活動は禁止されます。これは、.NET コードを直ちに終了させるものではありません。