Aspose.Cells में Excel से PDF में बाह्य संसाधनों को नियंत्रित करें

परिचय

आज के डिजिटल युग में, एक्सेल स्प्रेडशीट को पीडीएफ दस्तावेजों में बदलना एक आम काम है। चाहे वह रिपोर्ट, वित्तीय डेटा या प्रस्तुति सामग्री तैयार करना हो, आप यह सुनिश्चित करना चाहते हैं कि आपके पीडीएफ बिल्कुल वैसे ही दिखें जैसे आप उन्हें चाहते हैं। .NET के लिए Aspose.Cells एक मजबूत लाइब्रेरी है जो आपको इस रूपांतरण प्रक्रिया को अंतिम विवरण तक नियंत्रित करने की अनुमति देती है, खासकर जब आपकी एक्सेल फ़ाइलों के साथ आने वाली छवियों जैसे बाहरी संसाधनों को संभालना हो। इस गाइड में, हम Aspose.Cells का उपयोग करके एक्सेल से पीडीएफ रूपांतरण प्रक्रिया के दौरान बाहरी संसाधनों को नियंत्रित करने के तरीके के बारे में बता रहे हैं। तो, अपना पसंदीदा पेय लें, और चलिए शुरू करते हैं!

आवश्यक शर्तें

इससे पहले कि हम बारीकियों में जाएं, आइए सुनिश्चित करें कि आपके पास शुरू करने के लिए आवश्यक सभी चीजें हैं। यहाँ एक त्वरित चेकलिस्ट दी गई है:

1. विज़ुअल स्टूडियो या कोई भी .NET-संगत IDE: आपको अपना कोड लिखने और परीक्षण करने के लिए एक वातावरण की आवश्यकता होगी।
2. .NET के लिए Aspose.Cells: यदि आपने इसे अभी तक स्थापित नहीं किया है, तो यहां जाएंAspose डाउनलोड पेज पर जाएँ और नवीनतम संस्करण प्राप्त करें।
3. C# का बुनियादी ज्ञान: C# प्रोग्रामिंग भाषा से परिचित होना मददगार होगा। अगर आप किसी अवधारणा के बारे में अनिश्चित हैं, तो उसे देखने में संकोच न करें।
4. एक नमूना एक्सेल फ़ाइल: किसी भी बाहरी संसाधन के साथ एक एक्सेल फ़ाइल तैयार करें जिसे आप कनवर्ट करना चाहते हैं। आप प्रदान की गई नमूना फ़ाइल “samplePdfSaveOptions_StreamProvider.xlsx” का उपयोग कर सकते हैं।
5. परीक्षण के लिए एक छवि फ़ाइल: रूपांतरण के दौरान इसे बाहरी संसाधन के रूप में उपयोग किया जाएगा। छवि फ़ाइल “newPdfSaveOptions_StreamProvider.png” एक अच्छा प्लेसहोल्डर है।

पैकेज आयात करें

काम शुरू करने के लिए, आपको Aspose.Cells लाइब्रेरी से ज़रूरी नेमस्पेस आयात करने होंगे। इसकी कार्यक्षमताओं तक पहुँचने के लिए यह बहुत ज़रूरी है। अपनी फ़ाइल के शीर्ष पर निम्नलिखित using निर्देश अवश्य जोड़ें:

using System.IO;
using System.Drawing;
using System.Drawing.Imaging;
using Aspose.Cells;
using Aspose.Cells.Drawing;
using Aspose.Cells.Rendering;
using System;

ये पैकेज आपको अपने कार्यों को करने के लिए आवश्यक सभी कक्षाएं और विधियां प्रदान करेंगे।

चरण 1: अपना स्ट्रीम प्रदाता वर्ग बनाएँ

व्यवसाय का पहला क्रम एक स्ट्रीम प्रदाता वर्ग बनाना है जो कार्यान्वयन करता हैIStreamProvider इंटरफ़ेस। यह क्लास आपको यह नियंत्रित करने की अनुमति देगा कि बाहरी संसाधन कैसे लोड किए जाएं।

class MyStreamProvider : IStreamProvider
{
    public void CloseStream(StreamProviderOptions options)
    {
        Debug.WriteLine("-----Close Stream-----");
    }
    public void InitStream(StreamProviderOptions options)
    {
        string sourceDir = "Your Document Directory";
        Debug.WriteLine("-----Init Stream-----");
        // मेमोरी स्ट्रीम में नई छवि पढ़ें और इसे स्ट्रीम प्रॉपर्टी को असाइन करें
        byte[] bts = File.ReadAllBytes(sourceDir + "newPdfSaveOptions_StreamProvider.png");
        MemoryStream ms = new MemoryStream(bts);
        options.Stream = ms;
    }
}

इस वर्ग में:

• CloseStream: यह विधि तब कॉल की जाएगी जब स्ट्रीम बंद हो जाएगी। अभी के लिए, हम ट्रैकिंग के लिए सिर्फ़ एक डीबग संदेश लिख रहे हैं।
• InitStream: यहीं से जादू शुरू होता है। यहाँ, आप अपनी बाहरी छवि को बाइट ऐरे के रूप में पढ़ेंगे, इसे मेमोरी स्ट्रीम में बदलेंगे, और इसे असाइन करेंगेoptions.Stream संपत्ति।

चरण 2: स्रोत और आउटपुट निर्देशिकाएँ सेट करें

अब जब आपका स्ट्रीम प्रदाता तैयार है, तो यह निर्धारित करने का समय है कि आपकी एक्सेल फ़ाइल कहां स्थित है और आप अपनी पीडीएफ को कहां सहेजना चाहते हैं।

// स्रोत निर्देशिका
string sourceDir = "Your Document Directory";
// आउटपुट निर्देशिका
string outputDir = "Your Document Directory";

बस प्रतिस्थापित करें"Your Document Directory" आपके कंप्यूटर पर वास्तविक पथ के साथ जहाँ आपकी फ़ाइलें स्थित हैं। अपनी फ़ाइलों को व्यवस्थित रखना महत्वपूर्ण है!

चरण 3: अपनी एक्सेल फ़ाइल लोड करें

इसके बाद, आप वह एक्सेल फ़ाइल लोड करेंगे जिससे आप पीडीएफ बनाना चाहते हैं।

// बाह्य छवियों वाली स्रोत एक्सेल फ़ाइल लोड करें
Workbook wb = new Workbook(sourceDir + "samplePdfSaveOptions_StreamProvider.xlsx");

हम इसका प्रयोग कर रहे हैंWorkbook Aspose.Cells से क्लास, जो आपकी एक्सेल फ़ाइल का प्रतिनिधित्व करता है। फ़ाइल में विभिन्न बाहरी संसाधन शामिल हो सकते हैं जैसे छवियाँ जिन्हें आप रूपांतरण के दौरान नियंत्रित करना चाहते हैं।

चरण 4: पीडीएफ सेव विकल्प सेट करें

इससे पहले कि आप वर्कबुक को PDF के रूप में सेव करें, आइए यह तय करें कि आप इसे किस तरह से सेव करना चाहते हैं। आप अपनी ज़रूरत के हिसाब से इन विकल्पों को एडजस्ट कर सकते हैं।

// पीडीएफ सेव विकल्प निर्दिष्ट करें - स्ट्रीम प्रदाता
PdfSaveOptions opts = new PdfSaveOptions();
opts.OnePagePerSheet = true; // प्रत्येक शीट को नए पृष्ठ पर सहेजें

यहाँ, हम एक नया उदाहरण बना रहे हैंPdfSaveOptions , जो आपको यह अनुकूलित करने की अनुमति देता है कि आपका पीडीएफ कैसे प्रारूपित किया जाएगा।OnePagePerSheetयह विकल्प यह सुनिश्चित करने के लिए उपयोगी है कि प्रत्येक एक्सेल शीट को अंतिम पीडीएफ में अपना पृष्ठ मिले।

चरण 5: अपना स्ट्रीम प्रदाता निर्दिष्ट करें

अपने PDF विकल्प सेट करने के बाद, आपको Aspose को बाहरी संसाधनों के लिए अपने कस्टम स्ट्रीम प्रदाता का उपयोग करने के लिए कहना होगा।

wb.Settings.StreamProvider = new MyStreamProvider();

यह लाइन आपकेWorkbook उदाहरण के साथMyStreamProvider क्लास जिसे आपने पहले बनाया था। इसका मतलब यह है कि जब भी रूपांतरण के दौरान बाहरी संसाधनों का सामना करना पड़ता है, तो आपका प्रदाता उन्हें निर्दिष्ट तरीके से संभालेगा।

चरण 6: कार्यपुस्तिका को PDF के रूप में सहेजें

सब कुछ सेट हो जाने के बाद, अब समय आ गया है कि आप अपनी एक्सेल वर्कबुक को पीडीएफ के रूप में सेव करें।

// कार्यपुस्तिका को Pdf में सहेजें
wb.Save(outputDir + "outputPdfSaveOptions_StreamProvider.pdf", opts);

फोन करकेSave वर्कबुक ऑब्जेक्ट पर मेथड का उपयोग करके और पीडीएफ विकल्पों के साथ अपनी आउटपुट डायरेक्टरी को पास करके, आप एक्सेल फाइल को एक सुंदर स्वरूपित पीडीएफ में परिवर्तित कर रहे हैं।

चरण 7: सफल निष्पादन की पुष्टि करें

अंत में, यह पुष्टि करना हमेशा अच्छा होता है कि आपकी प्रक्रिया सफल रही है!

Console.WriteLine("ControlLoadingOfExternalResourcesInExcelToPDF executed successfully.\r\n");

कंसोल पर सफ़लता संदेश प्रिंट करने से आपको अपने ऑपरेशन की स्थिति के बारे में जानकारी रखने में मदद मिलती है। अपने कोड में इन छोटी-छोटी पुष्टियों को शामिल करना एक अच्छी आदत है।

निष्कर्ष

बस, अब यह हो गया! इन सरल चरणों का पालन करके, आप एक्सेल से पीडीएफ रूपांतरण के दौरान बाहरी संसाधनों को Aspose.Cells का उपयोग करके कुशलतापूर्वक नियंत्रित कर सकते हैं। इसका मतलब है कि आपके दस्तावेज़ अब छवियों और अन्य बाहरी तत्वों को सटीक रूप से शामिल कर सकते हैं, जिससे हर बार एक पॉलिश अंतिम उत्पाद सुनिश्चित होता है।

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

Aspose.Cells क्या है?

Aspose.Cells .NET डेवलपर्स के लिए एक शक्तिशाली लाइब्रेरी है जो आपको विभिन्न प्रारूपों में Excel फ़ाइलों को बनाने, हेरफेर करने, परिवर्तित करने और प्रस्तुत करने की अनुमति देती है।

मैं Aspose.Cells कैसे डाउनलोड करूं?

आप Aspose.Cells का नवीनतम संस्करण यहाँ से डाउनलोड कर सकते हैंलिंक को डाउनलोड करें.

क्या मैं Aspose.Cells को निःशुल्क आज़मा सकता हूँ?

हाँ! आप यहाँ जाकर निःशुल्क परीक्षण प्राप्त कर सकते हैंनिःशुल्क परीक्षण पृष्ठ.

मैं Aspose.Cells के लिए समर्थन कहां पा सकता हूं?

किसी भी सहायता-संबंधी प्रश्नों के लिए, आप यहां जा सकते हैंAspose सहायता मंच.

मैं Aspose.Cells के लिए अस्थायी लाइसेंस कैसे प्राप्त कर सकता हूं?

आप अस्थायी लाइसेंस के लिए आवेदन कर सकते हैंयहाँ.