.NET में GroupDocs.Annotation का उपयोग करके प्रीव्यू कैसे बनाएं

एक how to create preview अनुभव उत्पन्न करना आधुनिक दस्तावेज‑केंद्रित अनुप्रयोगों का एक मुख्य आधार है। GroupDocs.Annotation for .NET के साथ आप PDF थंबनेल इमेजेज रेंडर कर सकते हैं, सुरक्षित दस्तावेज़ प्रीव्यू स्ट्रीम बना सकते हैं, और मोबाइल डिवाइसों पर भी यूज़र इंटरफ़ेस को तेज़ रख सकते हैं। इस गाइड में आप जानेंगे कि प्रीव्यू जेनरेशन क्यों महत्वपूर्ण है, सामान्य कार्यान्वयन परिदृश्यों का अन्वेषण करेंगे, और अपने समाधान में उच्च‑गुणवत्ता वाले प्रीव्यू जोड़ने के लिए एक रोडमैप प्राप्त करेंगे।

त्वरित उत्तर

AnnotationApi क्लास GroupDocs.Annotation का मुख्य घटक है जो दस्तावेज़ लोड करता है और प्रीव्यू इमेजेज बनाता है। GetPages मेथड रेंडर किए गए पेज इमेजेज को बाइट एरे के रूप में लौटाता है। HideAnnotations फ़्लैग रेंडर की गई इमेज से सभी एनोटेशन लेयर को हटा देता है।

  • PDF थंबनेल को रेंडर करने का सबसे तेज़ तरीका क्या है? PDF को AnnotationApi के साथ लोड करें, DPI = 150 सेट करें, और GetPages कॉल करें – पहला पेज 2 MB फ़ाइल के लिए 200 ms से कम समय में PNG के रूप में लौटाया जाता है।
  • क्या मैं प्रीव्यू में सभी एनोटेशन छुपा सकता हूँ? हां – रेंडर करने से पहले HideAnnotations फ़्लैग का उपयोग करके एक साफ़ दृश्य बनाएं।
  • क्या प्रीव्यू जेनरेशन थ्रेड‑सेफ़ है? API स्टेटलेस है; आप सुरक्षित रूप से कई प्रीव्यू टास्क्स को समानांतर में चला सकते हैं।
  • क्या उत्पादन उपयोग के लिए लाइसेंस की आवश्यकता है? असीमित प्रीव्यू जेनरेशन के लिए एक वैध GroupDocs.Annotation लाइसेंस आवश्यक है।
  • कौन से .NET संस्करण समर्थित हैं? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6/7.

दस्तावेज़ प्रीव्यू क्या है?

एक दस्तावेज़ प्रीव्यू फ़ाइल का हल्का दृश्य प्रतिनिधित्व है—आमतौर पर एक इमेज या इमेजों की श्रृंखला—जो उपयोगकर्ताओं को पूर्ण दस्तावेज़ डाउनलोड किए बिना सामग्री को झलकने देता है। यह UX को सुधारता है, बैंडविड्थ कम करता है, और केवल वही दिखाकर सुरक्षा की एक परत जोड़ता है जिसे आप रेंडर करने का निर्णय लेते हैं।

सुरक्षित दस्तावेज़ प्रीव्यू क्यों उपयोग करें?

सुरक्षित दस्तावेज़ प्रीव्यू यह सुनिश्चित करता है कि संवेदनशील मेटाडेटा, छिपी लेयरें, या प्रतिबंधित एनोटेशन कभी सर्वर से बाहर न जाएँ। GroupDocs.Annotation प्रीव्यू स्ट्रीम को एन्क्रिप्ट करता है और किसी भी मार्कअप को हटा देता है जिसे आप स्पष्ट रूप से अनुमति नहीं देते, जिससे आपको अंतिम‑उपयोगकर्ताओं को दिखाने वाली चीज़ों पर पूर्ण नियंत्रण मिलता है। संख्यात्मक दावा: लाइब्रेरी 30+ फ़ाइल फ़ॉर्मैट का समर्थन करती है और डिफ़ॉल्ट DPI 150 का उपयोग करते हुए मानक 8‑कोर सर्वर पर 500‑पेज PDFs को 2 सेकंड से कम समय में प्रीव्यू जेनरेट कर सकती है।

आप PDF थंबनेल कैसे रेंडर करते हैं?

AnnotationApi के साथ PDF लोड करें, स्पष्ट टेक्स्ट के लिए DPI 150‑300 निर्दिष्ट करें, और पहला पेज PNG के रूप में अनुरोध करें। यह दो‑चरणीय दृष्टिकोण एक बाइट एरे लौटाता है जिसे आप सीधे ब्राउज़र में स्ट्रीम कर सकते हैं या डिस्क पर कैश कर सकते हैं। उच्च DPI (जैसे 300) टेक्स्ट‑भारी दस्तावेज़ों की पठनीयता बढ़ाता है, जबकि कम DPI (जैसे 72) थंबनेल ग्रिड के लिए फ़ाइल आकार घटाता है।

पूर्वापेक्षाएँ

  • .NET Framework 4.6+ या .NET Core 3.1+ स्थापित हो।
  • एक वैध GroupDocs.Annotation लाइसेंस (अस्थायी लाइसेंस मूल्यांकन के लिए काम करता है)।
  • PDF, Word, Excel, या अन्य समर्थित फ़ाइलों तक पहुँच जो आप प्रीव्यू करना चाहते हैं।

प्रीव्यू बनाने के चरण‑दर‑चरण

प्रीव्यू बनाने के लिए आपको GroupDocs.Annotation पैकेज इंस्टॉल करना होगा, अपने लाइसेंस के साथ API को इनिशियलाइज़ करना होगा, प्रीव्यू विकल्प कॉन्फ़िगर करने होंगे, इमेज जेनरेट करनी होगी, और वैकल्पिक रूप से परिणाम को कैश करना होगा। नीचे के सेक्शन प्रत्येक चरण को कोड उदाहरणों के साथ दिखाते हैं, जिसमें एनोटेशन छुपाना, DPI सेट करना, और बड़े फ़ाइलों को प्रभावी ढंग से संभालना शामिल है।

चरण 1: NuGet पैकेज इंस्टॉल करें

अपने प्रोजेक्ट के Package Manager Console को खोलें और चलाएँ:

Install-Package GroupDocs.Annotation

चरण 2: API को इनिशियलाइज़ करें

एक AnnotationApi इंस्टेंस बनाएं, अपने लाइसेंस फ़ाइल पाथ और वैकल्पिक कॉन्फ़िगरेशन (जैसे, कैश फ़ोल्डर, मेमोरी लिमिट) पास करते हुए।

var config = new AnnotationConfig
{
    LicensePath = "GroupDocs.Annotation.lic",
    CacheFolder = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Cache")
};
var annotationApi = new AnnotationApi(config);

चरण 3: एनोटेशन के बिना प्रीव्यू जेनरेट करें

HideAnnotations फ़्लैग को true सेट करें, इच्छित DPI चुनें, और आवश्यक पेज(es) का अनुरोध करें।

var previewOptions = new PreviewOptions
{
    HideAnnotations = true,
    Dpi = 150,
    OutputFormat = PreviewOutputFormat.Png,
    PageNumbers = new[] { 1 }   // first page only for thumbnail
};

byte[] previewBytes = annotationApi.GetPreview("sample.pdf", previewOptions);
File.WriteAllBytes("sample_thumb.png", previewBytes);

GetPreview कॉल एक बाइट एरे लौटाता है जिसे आप सीधे HTTP रिस्पॉन्स में भेज सकते हैं, CDN में स्टोर कर सकते हैं, या UI कॉम्पोनेन्ट में एम्बेड कर सकते हैं।

चरण 4: प्रीव्यू को कैश करें और पुन: उपयोग करें

एक ही प्रीव्यू को बार‑बार जेनरेट करने से बचने के लिए, स्रोत फ़ाइल और प्रीव्यू सेटिंग्स के हैश को कैश कुंजी के रूप में उपयोग करके इमेज को स्टोर करें। जब स्रोत दस्तावेज़ बदलता है, तो टाइमस्टैम्प की तुलना करके कैश को अमान्य करें।

string cacheKey = $"{Path.GetFileNameWithoutExtension(filePath)}_{previewOptions.Dpi}_{previewOptions.HideAnnotations}";

चरण 5: बड़े दस्तावेज़ों को प्रभावी ढंग से संभालें

100 MB से बड़ी फ़ाइलों के लिए, एक using ब्लॉक का उपयोग करें ताकि AnnotationApi आंतरिक स्ट्रीम्स को तुरंत डिस्पोज़ कर सके। यदि आपको मल्टी‑पेज प्रीव्यू चाहिए, तो पेजेज को बैच में प्रोसेस करें, प्रत्येक बैच को अगले पर जाने से पहले रिलीज़ करें।

सामान्य कार्यान्वयन परिदृश्य

  • डॉक्यूमेंट मैनेजमेंट सिस्टम – तेज़ विज़ुअल नेविगेशन के लिए थंबनेल इमेजेज का ग्रिड दिखाएँ।
  • कोलैबोरेशन प्लेटफ़ॉर्म – रिव्यूअर्स के लिए केवल प्रीव्यू व्यू रेंडर करें, फिर आवश्यकता अनुसार एनोटेशन लेयर को टॉगल करने की अनुमति दें।
  • वेब पोर्टल – फ़ाइल लिंक पर होवर करने पर प्रीव्यू दिखाएँ, जिससे पूर्ण डाउनलोड की आवश्यकता कम हो।
  • मोबाइल ऐप्स – बैंडविड्थ उपयोग को प्रति पेज 50 KB से कम रखने के लिए लो‑रेज़ोल्यूशन PNGs (72 DPI) जेनरेट करें।

प्रीव्यू जेनरेशन की समस्या निवारण

  • बड़े PDFs के साथ मेमोरी स्पाइक – प्रत्येक प्रीव्यू बैच के बाद AnnotationApi पर Dispose() कॉल करना सुनिश्चित करें, और समवर्ती प्रीव्यू टास्क्स की संख्या सीमित रखें।
  • थंबनेल में धुंधला टेक्स्ट – DPI को 300 तक बढ़ाएँ या आउटपुट फ़ॉर्मेट को PNG में बदलें; JPEG कम्प्रेशन पतले अक्षरों को नरम कर सकता है।
  • Excel प्रीव्यू में छवियां गायब – प्रीव्यू विकल्पों में LoadCharts = true सेट करके वर्कबुक के चार्ट ऑब्जेक्ट्स को पूरी तरह लोड होना सुनिश्चित करें।
  • धीमी प्रतिक्रिया समय – प्रीव्यू जेनरेशन को बैकग्राउंड वर्कर (जैसे, Task.Run) में ले जाएँ और वास्तविक प्रीव्यू तैयार होने तक प्लेसहोल्डर इमेज सर्व करें।

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

प्र: क्या मैं पासवर्ड‑सुरक्षित दस्तावेज़ों के लिए प्रीव्यू जेनरेट कर सकता हूँ?
उ: हाँ। AnnotationApi इंस्टेंस बनाते समय LoadOptions में पासवर्ड प्रदान करें; सफल डिक्रिप्शन के बाद प्रीव्यू जेनरेट होगा।

प्र: क्या लाइब्रेरी DOCX या XLSX जैसे गैर‑PDF फ़ॉर्मैट्स के लिए प्रीव्यू रेंडर करने का समर्थन करती है?
उ: बिलकुल। GroupDocs.Annotation 30 से अधिक विभिन्न फ़ॉर्मैट्स के लिए प्रीव्यू रेंडर कर सकता है, जिसमें DOCX, XLSX, PPTX, और कई इमेज टाइप्स शामिल हैं।

प्र: मैं कैसे सुनिश्चित करूँ कि प्रीव्यू छिपा हुआ मेटाडेटा न दिखाए?
उ: PreviewOptions में HideMetadata विकल्प का उपयोग करें; API इमेज रेंडर करने से पहले सभी दस्तावेज़ प्रॉपर्टीज़ को हटा देता है।

प्र: क्या प्रीव्यू एंडपॉइंट को सार्वजनिक रूप से एक्सपोज़ करना सुरक्षित है?
उ: प्रीव्यू स्ट्रीम सर्वर‑साइड जेनरेट होती है और HTTPS के माध्यम से डिलीवर की जा सकती है। इसे टोकन‑आधारित ऑथेंटिकेशन के साथ मिलाकर केवल अधिकृत उपयोगकर्ताओं तक पहुँच सीमित रखें।

प्र: अनुशंसित कैश एक्सपायरी नीति क्या है?
उ: स्रोत दस्तावेज़ संस्करण की आयु तक प्रीव्यू को कैश करें। जब दस्तावेज़ का अंतिम‑संशोधित टाइमस्टैम्प बदलता है, तो कैश्ड इमेज को अमान्य करें और पुनः जेनरेट करें।

अतिरिक्त संसाधन

अंतिम अपडेट: 2026-08-09
परीक्षण किया गया: GroupDocs.Annotation 23.10 for .NET
लेखक: GroupDocs

संबंधित ट्यूटोरियल