ES CSharp Cancellation

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

Cancelar, pausar y scripts en segundo plano

Manual C# · Ejemplos UO

CancellationTokenSource crea una solicitud de cancelación, CancellationToken se pasa a la operación. La cancelación es cooperativa: la operación verifica el token o lo transmite. El script incrustado obtiene Cancellation; WaitAsync se usa para esperar.

Ejemplo sencillo (Example.csx)

Guarde este ejemplo por separado como Example.csx. Ejecútelo independientemente de los demás ejemplos de esta página.

Example.csx:

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

La cancelación es cooperativa: la comprobación del token y WaitAsync responden a Stop; el código externo sin soporte de cancelación puede continuar.

Resultado:

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");
    }
}

No reemplace detener el script con una intercepción infinita OperationCanceledException. Una llamada de bloqueo arbitraria a una biblioteca de terceros no se vuelve interrumpible solo por la presencia de un token. Pausar y pedir cancelar tienen diferentes propósitos: la pausa preserva la continuación, la cancelación finaliza la ejecución.

Documentación oficial: Cancelar, pausar y scripts en segundo plano - Microsoft Learn.

La solicitud de cancelación es cooperativa. Task.Delay sin transferencia Cancellation, la espera de tareas de terceros y llamadas a la biblioteca sin cancelar el soporte puede continuar después de presionar Stop. Una vez realizada una solicitud de cancelación, se prohíben otras actividades de juego relacionadas con esa ejecución; esto no obliga a que ningún código .NET finalice inmediatamente.