Support pour la bibliothèque Interruptable

Bibliothèque Interruptible

Dans Aspose.Slides 18.4, nous avons introduit les classes InterruptionToken et InterruptionTokenSource. Elles vous permettent d’interrompre des tâches longues telles que la désérialisation, la sérialisation et le rendu.

• InterruptionTokenSource est la source des jetons transmis à ILoadOptions.InterruptionToken.
• Lorsque ILoadOptions.InterruptionToken est défini et que l’instance de LoadOptions est transmise au constructeur de Presentation, l’appel de InterruptionTokenSource.Interrupt() interrompt toute tâche longue associée à cette Presentation.

Le fragment de code suivant montre comment interrompre une tâche en cours d’exécution :

public static void Run()
{
    Action<IInterruptionToken> action = (IInterruptionToken token) =>
    {
        LoadOptions options = new LoadOptions { InterruptionToken = token };
        using (Presentation presentation = new Presentation("sample.pptx", options))
        {
            presentation.Save("sample.ppt", SaveFormat.Ppt);
        }
    };

    InterruptionTokenSource tokenSource = new InterruptionTokenSource();
    Run(action, tokenSource.Token); // exécuter l'action dans un thread séparé
    Thread.Sleep(10000);            // délai d'attente
    tokenSource.Interrupt();        // arrêter la conversion
}

private static void Run(Action<IInterruptionToken> action, IInterruptionToken token)
{
    Task.Run(() => { action(token); });
}

CancellationToken .NET et Bibliothèque Interruptible

Lorsque vous devez utiliser un CancellationToken avec la bibliothèque Interruptible d’Aspose.Slides, encapsulez le traitement de la Presentation et interrompez le InterruptionToken lorsque CancellationToken.IsCancellationRequested est true.

Ce code C# illustre le fonctionnement :

public static void Main()
{
    CancellationTokenSource tokenSource = new CancellationTokenSource(TimeSpan.FromSeconds(20));
    ProcessPresentation("sample.pptx", "sample.pdf", tokenSource.Token);
}

static void ProcessPresentation(string path, string outPath, CancellationToken cancellationToken)
{
    Action<IInterruptionToken> action = (IInterruptionToken token) =>
    {
        LoadOptions options = new LoadOptions {InterruptionToken = token};
        using (Presentation presentation = new Presentation(path, options))
        {
            presentation.Save(outPath, SaveFormat.Pdf);
        }
    };
    
    InterruptionTokenSource tokenSource = new InterruptionTokenSource();
    Task task = Run(action, tokenSource.Token); // exécuter l'action dans un thread séparé

    while (!task.Wait(500)) // attendre et surveiller si cancellationToken.IsCancellationRequested est défini
    {
        if (cancellationToken.IsCancellationRequested)
        {
            Console.WriteLine("Presentation processing was canceled");
            tokenSource.Interrupt(); // interrompre le traitement de la présentation
        }
    }
}

private static Task Run(Action<IInterruptionToken> action, IInterruptionToken token)
{
    return Task.Run(() =>
    {
        action(token);
    });
}

FAQ

Quel est le but de la bibliothèque d’interruption Aspose.Slides ?

Elle fournit un mécanisme pour interrompre les opérations longues—comme le chargement, l’enregistrement ou le rendu de présentations—avant leur achèvement. Cela est utile lorsque le temps de traitement doit être limité ou que la tâche n’est plus nécessaire.

Quelle est la différence entre InterruptionToken et InterruptionTokenSource?

• InterruptionToken est transmis à l’API Aspose.Slides et vérifié pendant les opérations longues.
• InterruptionTokenSource est utilisé dans votre code pour créer des jetons et déclencher des interruptions en appelant Interrupt().

Puis‑je utiliser le CancellationToken .NET avec la bibliothèque d’interruption ?

Oui. Vous pouvez surveiller le CancellationToken dans votre logique d’application et appeler InterruptionTokenSource.Interrupt() lorsque l’annulation est demandée. Cela permet à Aspose.Slides de s’intégrer aux flux d’annulation standard de .NET.

Quelles tâches peuvent être interrompues ?

Toute tâche Aspose.Slides qui accepte un InterruptionToken—comme le chargement d’une présentation avec Presentation(path, loadOptions) ou l’enregistrement avec Presentation.Save(...)—peut être interrompue.

L’interruption se produit‑elle immédiatement ?

Non. L’interruption est coopérative : l’opération vérifie périodiquement le jeton et s’arrête dès qu’elle détecte qu’un appel à Interrupt() a été effectué.

Que se passe‑t‑il si j’appelle Interrupt() après qu’une tâche soit déjà terminée ?

Rien — l’appel n’a aucun effet si la tâche correspondante est déjà terminée.

Puis‑je réutiliser le même InterruptionTokenSource pour plusieurs tâches ?

Oui—mais après avoir appelé Interrupt() sur cette source, toutes les tâches utilisant ses jetons seront interrompues. Utilisez des sources de jetons distinctes pour gérer les tâches de manière indépendante.