Interruptable लाइब्रेरी के लिए समर्थन

अवलोकन

Aspose.Slides for .NET लंबी अवधि के प्रेज़ेंटेशन कार्यों, जैसे कि डीसिरियलाइज़ेशन, सीरियलाइज़ेशन और रेंडरिंग, के लिए एक इंटर्रप्टेबल प्रोसेसिंग मैकेनिज्म प्रदान करता है। यह मैकेनिज्म InterruptionToken और InterruptionTokenSource क्लासों पर आधारित है।

InterruptionToken को LoadOptions को असाइन किया जा सकता है और Presentation कन्स्ट्रक्टर को पास किया जा सकता है। जब InterruptionTokenSource.Interrupt() को कॉल किया जाता है, तो संबंधित लंबी अवधि का कार्य बाधित हो जाता है। यह लेख यह भी दर्शाता है कि इस मैकेनिज्म को मानक .NET CancellationToken के साथ कैसे उपयोग किया जाए, जिससे रद्दीकरण अनुरोधों की निगरानी की जा सके और रद्दीकरण का अनुरोध होने पर Interrupt() को कॉल किया जाए।

इंटर्रप्टेबल लाइब्रेरी

In Aspose.Slides 18.4, we introduced the InterruptionToken and InterruptionTokenSource classes. They allow you to interrupt long-running tasks such as deserialization, serialization, and rendering.

InterruptionTokenSource टोकन(स) का स्रोत है जो ILoadOptions.InterruptionToken को पास किया जाता है।
जब ILoadOptions.InterruptionToken सेट किया जाता है और LoadOptions की इंस्टेंस को Presentation कन्स्ट्रक्टर में पास किया जाता है, तो InterruptionTokenSource.Interrupt() को कॉल करने से उस Presentation से जुड़ा कोई भी लंबा कार्य बाधित हो जाता है।

निम्नलिखित कोड स्निपेट चल रहे कार्य को बाधित करने का प्रदर्शन करता है:

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); // एक अलग थ्रेड में क्रिया चलाएँ
    Thread.Sleep(10000);            // समय समाप्ति
    tokenSource.Interrupt();        // रूपांतरण रोकें
}

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

.NET CancellationToken और इंटर्रप्टेबल लाइब्रेरी

When you need to use a CancellationToken alongside the Aspose.Slides Interruptible library, wrap the Presentation processing and interrupt the InterruptionToken when CancellationToken.IsCancellationRequested is true.

यह C# कोड इस कार्य को दर्शाता है:

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); // एक अलग थ्रेड में क्रिया चलाएँ

    while (!task.Wait(500)) // रुकें और मॉनिटर करें कि cancellationToken.IsCancellationRequested सेट है या नहीं
    {
        if (cancellationToken.IsCancellationRequested)
        {
            Console.WriteLine("Presentation processing was canceled");
            tokenSource.Interrupt(); // Presentation प्रोसेसिंग को बाधित करें
        }
    }
}

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

अक्सर पूछे जाने वाले प्रश्न

Aspose.Slides इंटर्रप्ट लाइब्रेरी का उद्देश्य क्या है?

यह लंबी अवधि के ऑपरेशनों—जैसे कि प्रेज़ेंटेशन को लोड करना, सेव करना, या रेंडर करना—को समाप्त होने से पहले बाधित करने का मैकेनिज्म प्रदान करता है। यह तब उपयोगी होता है जब प्रोसेसिंग समय सीमित होना चाहिए या कार्य अब आवश्यक नहीं रहता।

InterruptionToken और InterruptionTokenSource में क्या अंतर है?

InterruptionToken को Aspose.Slides API को पास किया जाता है और लंबी अवधि के ऑपरेशनों के दौरान जाँचा जाता है।
InterruptionTokenSource का उपयोग आपके कोड में टोकन बनाने और Interrupt() को कॉल करके बाधित करने के लिए किया जाता है।

क्या मैं .NET CancellationToken को इंटर्रप्ट लाइब्रेरी के साथ उपयोग कर सकता हूँ?

हां। आप अपने एप्लिकेशन लॉजिक में CancellationToken की निगरानी कर सकते हैं और रद्दीकरण के अनुरोध पर InterruptionTokenSource.Interrupt() को कॉल कर सकते हैं। यह Aspose.Slides को मानक .NET रद्दीकरण वर्कफ़्लो के साथ एकीकृत करने में सक्षम बनाता है।

क्या कार्य बाधित किए जा सकते हैं?

कोई भी Aspose.Slides कार्य जो InterruptionToken स्वीकार करता है—जैसे Presentation(path, loadOptions) से प्रेज़ेंटेशन लोड करना या Presentation.Save(...) से सेव करना—को बाधित किया जा सकता है।

क्या बाधित करना तुरंत होता है?

नहीं। बाधित करना सहयोगात्मक होता है: ऑपरेशन नियमित रूप से टोकन को जाँचता है और जैसे ही यह पहचानता है कि Interrupt() को कॉल किया गया है, रोक देता है।

यदि मैं किसी कार्य के पूरा होने के बाद Interrupt() को कॉल करता हूँ तो क्या होता है?

कुछ नहीं—यदि संबंधित कार्य पहले ही पूरा हो चुका है, तो कॉल का कोई प्रभाव नहीं रहता।

क्या मैं कई कार्यों के लिए एक ही InterruptionTokenSource का पुन: उपयोग कर सकता हूँ?

हां—लेकिन जब आप उस स्रोत पर Interrupt() को कॉल करते हैं, तो उसके टोकन का उपयोग करने वाले सभी कार्य बाधित हो जाएंगे। कार्यों को स्वतंत्र रूप से प्रबंधित करने के लिए अलग-अलग टोकन स्रोतों का उपयोग करें।

.NET में प्रेज़ेंटेशन स्लाइड्स पर शैप्स का आकार बदलें ASP.NET Core में बैकग्राउंड टास्क कैसे चलाएँ