FTP से .NET में PDF में एनोटेशन जोड़ें

FTP सर्वर से PDF लोड करना और फिर PDF में एनोटेशन जोड़ना फ़ाइलें एंटरप्राइज़ के लिए एक सामान्य आवश्यकता है जो लेगेसी दस्तावेज़ों को ऑन‑प्रिमाइसेस स्टोरेज में रखते हैं। इस ट्यूटोरियल में आप देखेंगे कि FTP से फ़ाइल कैसे डाउनलोड करें, उसे GroupDocs.Annotation में फ़ीड करें, और हाइलाइट, कमेंट या शैप्स लागू करें—बिना फ़ाइल को पहले डिस्क पर लिखे। अंत तक आपके पास एक पुन: उपयोग योग्य पैटर्न होगा जो किसी भी FTP‑एक्सेसिबल PDF के साथ काम करता है और GroupDocs.Annotation द्वारा समर्थित अन्य फ़ॉर्मैट्स में विस्तारित किया जा सकता है।

त्वरित उत्तर

  • इस ट्यूटोरियल में क्या कवर किया गया है? FTP से PDF लोड करना और GroupDocs.Annotation for .NET के साथ एनोटेशन जोड़ना।
  • कौन सा मुख्य कीवर्ड लक्षित है? add annotations to pdf.
  • क्या मुझे लाइसेंस की जरूरत है? एक मुफ्त ट्रायल उपलब्ध है, लेकिन प्रोडक्शन उपयोग के लिए एक वैध GroupDocs.Annotation लाइसेंस आवश्यक है।
  • क्या मैं इसे .NET Core के साथ उपयोग कर सकता हूँ? हां, कोड .NET Framework 4.6.1+ और .NET Core 2.0+ के साथ काम करता है।
  • क्या प्रमाणीकरण समर्थित है? उदाहरण में अनाम FTP दिखाया गया है; आप सुरक्षित एक्सेस के लिए NetworkCredential जोड़ सकते हैं।

“add annotations to pdf” क्या है?

Add annotations to PDF का अर्थ है प्रोग्रामेटिक रूप से मौजूदा PDF दस्तावेज़ में हाइलाइट, कमेंट, स्टैम्प या शैप्स डालना। GroupDocs.Annotation for .NET एक हाई‑लेवल API प्रदान करता है जो सीधे स्ट्रीम्स के साथ काम करता है, इसलिए आप रिमोट FTP सर्वर पर मौजूद PDF को स्थानीय रूप से सहेजे बिना संशोधित कर सकते हैं।

FTP से दस्तावेज़ लोड क्यों करें?

FTP से दस्तावेज़ लोड करना एप्लिकेशन को केंद्रीकृत फ़ाइलों तक मैन्युअल कॉपी के बिना पहुँचने देता है, फ़ाइलों को जगह पर प्रोसेस करके लेटेंसी कम करता है, और ऑन‑डिमांड दस्तावेज़ खींचने वाले ऑटोमेटेड वर्कफ़्लो को सपोर्ट करता है, जिससे हमेशा नवीनतम संस्करण उपयोग में रहता है और आंतरिक डेटा‑हैंडलिंग नीतियों के साथ अनुपालन बना रहता है।

  • केंद्रीकृत स्टोरेज: लेगेसी एंटरप्राइज़ का 70 % से अधिक अभी भी बड़े दस्तावेज़ आर्काइव के लिए FTP पर निर्भर करता है।
  • बैच प्रोसेसिंग: FTP आपको एक ही जॉब में सैकड़ों फ़ाइलें खींचने देता है, जिससे ऑटोमेटेड एनोटेशन पाइपलाइन संभव होती है।
  • अनुपालन: ऑन‑प्रिमाइसेस FTP डेटा को नियंत्रित नेटवर्क ज़ोन में रखता है, जिससे कई नियामक आवश्यकताओं को पूरा किया जा सकता है।

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

  • C# मूल बातें – स्ट्रीम्स और async पैटर्न में सहज।
  • GroupDocs.Annotation for .NET – official release page से डाउनलोड करें और सामान्य release page देखें।
  • FTP क्रेडेंशियल्स – होस्ट, यूज़रनेम, पासवर्ड (यदि आवश्यक हो) और लक्ष्य फ़ाइलों को पढ़ने की अनुमति।
  • डेवलपमेंट टूल्स – Visual Studio 2019+ और .NET Framework 4.6.1 या .NET Core 2.0+।

.NET में FTP से PDF में एनोटेशन कैसे जोड़ें?

इस गाइड में हम FTP सर्वर से PDF डाउनलोड करेंगे, स्ट्रीम को GroupDocs.Annotation में फ़ीड करेंगे, एक हाइलाइट एनोटेशन जोड़ेंगे, और एनोटेटेड फ़ाइल को सहेजेंगे—बिना अस्थायी फ़ाइलें डिस्क पर लिखे। AnnotationConfig GroupDocs.Annotation को एक विशिष्ट दस्तावेज़ स्ट्रीम और फ़ॉर्मैट के साथ काम करने के लिए कॉन्फ़िगर करता है। FtpWebRequest एक .NET क्लास है जो फ़ाइल डाउनलोड जैसी FTP ऑपरेशन्स को संभालता है। HighlightAnnotation PDF पेज पर रखी गई एक विज़ुअल हाइलाइट को दर्शाता है।

चरण 1: स्थानीय आउटपुट पाथ निर्धारित करें

पहले तय करें कि प्रोसेसिंग के बाद एनोटेटेड PDF कहाँ सहेजा जाएगा। Path.Combine का उपयोग करने से Windows और Linux पर सही पाथ सेपरेटर सुनिश्चित होते हैं।

नोट: Save कॉल करने से पहले आउटपुट फ़ोल्डर मौजूद होना चाहिए। यदि आवश्यक हो तो इसे प्रोग्रामेटिकली बनाएं।

चरण 2: FTP से PDF स्ट्रीम प्राप्त करें

हेल्पर मेथड GetFileFromFtp एक FtpWebRequest खोलता है, रिस्पॉन्स को MemoryStream में पढ़ता है, और स्ट्रीम को शुरुआत में पोजिशन करके रिटर्न करता है। यही स्ट्रीम GroupDocs.Annotation उपभोग करता है।

Security tip: प्रोडक्शन में हमेशा request.Credentials = new NetworkCredential(user, pass) सेट करें और SSL (EnableSsl = true) को एनेबल करें ताकि क्रेडेंशियल्स सुरक्षित रहें।

चरण 3: स्ट्रीम के साथ GroupDocs.Annotation को इनिशियलाइज़ करें

AnnotationConfig ऑब्जेक्ट GroupDocs.Annotation को बताता है कि आप किस फ़ाइल प्रकार के साथ काम कर रहे हैं और कौन सी स्ट्रीम पढ़नी है। स्ट्रीम को सीधे पास करने से अस्थायी फ़ाइलें बचती हैं और I/O ओवरहेड कम होता है।

चरण 4: हाइलाइट एनोटेशन जोड़ें

एक HighlightAnnotation (या कोई अन्य एनोटेशन टाइप) बनाएं और उसकी लोकेशन, साइज, और रंग कॉन्फ़िगर करें। उदाहरण में एक चमकीला पीला (BackgroundColor = 65535) उपयोग किया गया है जो अधिकांश PDF पर स्पष्ट दिखता है।

चरण 5: एनोटेटेड दस्तावेज़ को सहेजें

annotation.Save(outputPath) कॉल करके अपडेटेड PDF को चरण 1 में निर्धारित स्थान पर लिखें। कंसोल आउटपुट सफलता की पुष्टि करता है और पूर्ण पाथ दिखाता है।

चरण 6: सब कुछ try/catch में रैप करें

नेटवर्क ऑपरेशन्स टाइमआउट और परमिशन एरर के प्रति संवेदनशील होते हैं। पूरे फ्लो को try/catch ब्लॉक में रखें, एक्सेप्शन को लॉग करें, और वैकल्पिक रूप से डाउनलोड को रीट्राई करें।

सामान्य FTP लोडिंग समस्याएँ और समाधान

कनेक्शन टाइमआउट

FTP सर्वर कुछ समय बाद आइडल कनेक्शन बंद कर सकते हैं। टाइमआउट बढ़ाने के लिए request.Timeout = 30000 (30 सेकंड) या उससे अधिक सेट करें।

प्रमाणीकरण विफलताएँ

यदि आपको 530 एरर मिलता है, तो यूज़रनेम/पासवर्ड दोबारा जांचें और सुनिश्चित करें कि अकाउंट को लक्ष्य डायरेक्टरी के लिए रीड परमिशन है। FTPS (EnableSsl = true) पर स्विच करने से अक्सर क्रेडेंशियल‑संबंधी समस्याएँ हल हो जाती हैं।

फ़ायरवॉल और पैसिव मोड

कई कॉर्पोरेट फ़ायरवॉल एक्टिव FTP द्वारा उपयोग किए जाने वाले डेटा चैनल को ब्लॉक करते हैं। क्लाइंट को डेटा कनेक्शन खोलने देने के लिए request.UsePassive = true के साथ पैसिव मोड एनेबल करें।

बड़े फ़ाइल हैंडलिंग

यदि PDF 100 MB से बड़ी है, तो रिस्पॉन्स को सीधे एक अस्थायी फ़ाइल में स्ट्रीम करने और फिर GroupDocs.Annotation के लिए FileStream खोलने पर विचार करें। इससे पूरी फ़ाइल मेमोरी में रहने से बचती है।

सुरक्षा विचार

  • क्रेडेंशियल्स को कभी हार्ड‑कोड न करें – उन्हें Azure Key Vault, AWS Secrets Manager, या एनवायरनमेंट वेरिएबल्स में स्टोर करें।
  • FTPS या SFTP को प्राथमिकता दें – साधारण FTP क्रेडेंशियल्स को क्लियर टेक्स्ट में ट्रांसमिट करता है।
  • URLs को वैलिडेट करें – FTP होस्ट को व्हाइटलिस्ट तक सीमित रखें ताकि SSRF अटैक से बचा जा सके।
  • फ़ाइल नामों को सैनिटाइज़ करें – .. या अनपेक्षित कैरेक्टर्स वाले पाथ को रिजेक्ट करें ताकि डायरेक्टरी ट्रैवर्सल रोका जा सके।

वास्तविक‑दुनिया उपयोग केस

  • रेगुलेटरी रिव्यू पोर्टल्स – ऑन‑प्रिम FTP आर्काइव से कंप्लायंस PDF खींचें, ऑडिटर्स को कमेंट जोड़ने दें, और एनोटेटेड वर्ज़न को सुरक्षित लोकेशन पर वापस स्टोर करें।
  • लेगेसी रिपोर्ट ऑटोमेशन – दैनिक वित्तीय रिपोर्टें FTP ड्रॉप फ़ोल्डर में आती हैं; सेवा स्वचालित रूप से प्रमुख आंकड़ों को हाइलाइट करती है और एनोटेटेड रिपोर्ट को स्टेकहोल्डर्स को ईमेल करती है।
  • माइग्रेशन असिस्टेंट्स – जब दस्तावेज़ों को FTP से क्लाउड DMS में माइग्रेट किया जाता है, तो प्रत्येक फ़ाइल को माईग्रेशन स्टेटस फ्लैग्स के साथ एनोटेट करें बिना मैन्युअल हस्तक्षेप के।

प्रदर्शन अनुकूलन टिप्स

  • FtpWebRequest ऑब्जेक्ट्स को पुन: उपयोग करें जब कई फ़ाइलों को प्रोसेस कर रहे हों ताकि हैंडशेक ओवरहेड कम हो।
  • FTP कॉल्स को असिंक्रोनसली एक्सीक्यूट करें (await GetFileFromFtpAsync) ताकि UI थ्रेड रिस्पॉन्सिव रहे।
  • बार‑बार एक्सेस की जाने वाली PDFs को स्थानीय रूप से छोटे समय (जैसे 5 मिनट) के लिए कैश करें जब वही फ़ाइल बार‑बार एनोटेट की जाती है।
  • बैच एनोटेट – कई PDFs को अलग‑अलग Annotation इंस्टेंस में लोड करें, एनोटेशन लागू करें, और फिर एक ही I/O ऑपरेशन में उन्हें पर्सिस्ट करें।

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

Q: क्या मैं PDF के अलावा अन्य फ़ाइल प्रकारों पर एनोटेशन कर सकता हूँ?
A: हाँ, GroupDocs.Annotation 30 से अधिक फ़ॉर्मैट्स को सपोर्ट करता है, जिसमें DOCX, PPTX और सामान्य इमेज टाइप्स शामिल हैं, जिन्हें सभी एक ही स्ट्रीम‑आधारित अप्रोच से FTP से लोड किया जा सकता है।

Q: हाइलाइट के बजाय कमेंट एनोटेशन कैसे जोड़ूँ?
A: CommentAnnotation को इंस्टैंशिएट करें, उसकी Text प्रॉपर्टी सेट करें, और इसे Annotations कलेक्शन में हाइलाइट उदाहरण की तरह जोड़ें।

Q: क्या एनोटेटेड फ़ाइल को फिर से FTP सर्वर पर लिखना संभव है?
A: बिल्कुल। स्थानीय रूप से सहेजने के बाद, Method = WebRequestMethods.Ftp.UploadFile के साथ एक नया FtpWebRequest खोलें और फ़ाइल स्ट्रीम को रिमोट पाथ पर वापस लिखें।

Q: कौन से .NET संस्करण आधिकारिक रूप से सपोर्टेड हैं?
A: GroupDocs.Annotation for .NET .NET Framework 4.6.1+, .NET Core 2.0+, .NET 5, और .NET 6 के साथ काम करता है।

Q: पासवर्ड‑प्रोटेक्टेड PDFs को कैसे हैंडल करूँ?
A: स्ट्रीम लोड करने से पहले AnnotationConfig कन्स्ट्रक्टर में Password प्रॉपर्टी के माध्यम से पासवर्ड पास करें।

निष्कर्ष

आपके पास अब एक पूर्ण, प्रोडक्शन‑रेडी पैटर्न है add annotations to pdf फ़ाइलों के लिए जो FTP सर्वर पर स्थित हैं। फ़ाइल को सीधे GroupDocs.Annotation में स्ट्रीम करके आप अनावश्यक डिस्क I/O से बचते हैं, एप्लिकेशन को हल्का रखते हैं, और सुरक्षा एवं प्रदर्शन पर पूर्ण नियंत्रण बनाए रखते हैं। इस बुनियाद को ऑथेंटिकेशन, प्रोग्रेस रिपोर्टिंग, या बैच प्रोसेसिंग के साथ विस्तारित करें ताकि एंटरप्राइज़ दस्तावेज़ वर्कफ़्लो की मांगों को पूरा किया जा सके।

अतिरिक्त मदद के लिए, support forum पर जाएँ।

अंतिम अपडेट: 2026-07-06
परीक्षित संस्करण: GroupDocs.Annotation 23.12 for .NET
लेखक: GroupDocs

using GroupDocs.Annotation.Models;
using GroupDocs.Annotation.Models.AnnotationModels;
using System;
using System.IO;
using System.Net;

string outputPath = Path.Combine("Your Document Directory", "result" + Path.GetExtension("input.pdf"));

string filePath = "sample.pdf";
using (Annotator annotator = new Annotator(GetFileFromFtp(filePath)))
{
    // Annotation code will be added here
}

AreaAnnotation area = new AreaAnnotation()
{
    Box = new Rectangle(100, 100, 100, 100),
    BackgroundColor = 65535,
};
annotator.Add(area);

annotator.Save(outputPath);
Console.WriteLine($"\nDocument saved successfully.\nCheck output in {outputPath}.");

private static Stream GetFileFromFtp(string filePath)
{
    Uri uri = new Uri(filePath);
    FtpWebRequest request = CreateRequest(uri);
    using (WebResponse response = request.GetResponse())
        return GetFileStream(response);
}

private static FtpWebRequest CreateRequest(Uri uri)
{
    FtpWebRequest request = (FtpWebRequest)WebRequest.Create(uri);
    request.Method = WebRequestMethods.Ftp.DownloadFile;
    return request;
}

private static Stream GetFileStream(WebResponse response)
{
    MemoryStream fileStream = new MemoryStream();
    using (Stream responseStream = response.GetResponseStream())
        responseStream.CopyTo(fileStream);
    fileStream.Position = 0;
    return fileStream;
}

request.Timeout = 30000; // 30 seconds

request.Credentials = new NetworkCredential("username", "password");

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