GroupDocs.Redaction for .NET में कस्टम लॉगर C# लागू करें

दस्तावेज़ रिडैक्शन को कुशलतापूर्वक प्रबंधित करना अत्यंत महत्वपूर्ण है, विशेष रूप से संवेदनशील जानकारी को संभालते समय। इस गाइड में आप GroupDocs.Redaction for .NET के साथ how to implement a custom logger c# सीखेंगे, जिससे आपको लॉगिंग, त्रुटि प्रबंधन और ऑडिट ट्रेल्स पर पूर्ण नियंत्रण मिलेगा। ट्यूटोरियल के अंत तक आप चेतावनियों, त्रुटियों और सूचना संदेशों को कैप्चर कर सकेंगे, लॉगर को मौजूदा .NET लॉगिंग फ्रेमवर्क के साथ एकीकृत कर सकेंगे, और रिडैक्टेड दस्तावेज़ को बिना रास्टराइज़ेशन के सहेज सकेंगे।

त्वरित उत्तर

• कस्टम लॉगर C# क्या करता है? यह रिडैक्शन के दौरान त्रुटियों, चेतावनियों और सूचना संदेशों को कैप्चर करता है, जिससे आपको एक खोज योग्य ऑडिट ट्रेल मिलता है।
• कौन सी लाइब्रेरी ILogger इंटरफ़ेस प्रदान करती है? GroupDocs.Redaction for .NET ILogger इंटरफ़ेस प्रदान करता है।
• क्या मैं रास्टराइज़ेशन के बिना रिडैक्टेड दस्तावेज़ सहेज सकता हूँ? हाँ – redactor.Save(..., new Options.RasterizationOptions { Enabled = false }) को कॉल करें।
• क्या उत्पादन उपयोग के लिए लाइसेंस की आवश्यकता है? उत्पादन के लिए पूर्ण लाइसेंस आवश्यक है; मूल्यांकन के लिए एक ट्रायल लाइसेंस उपलब्ध है।
• क्या यह तरीका .NET Core / .NET 6+ के साथ संगत है? बिल्कुल – वही API .NET Framework, .NET Core, .NET 5, और .NET 6 में काम करता है।

कस्टम लॉगर C# क्या है?

custom logger c# एक क्लास है जो GroupDocs.Redaction द्वारा प्रदान किए गए ILogger इंटरफ़ेस को लागू करती है। यह आपको लॉग संदेशों को जहाँ भी आवश्यक हो—कंसोल, फ़ाइल, डेटाबेस, या बाहरी मॉनिटरिंग सिस्टम—पर रूट करने देती है, साथ ही रिडैक्शन वर्कफ़्लो का स्पष्ट दृश्य प्रदान करती है।

GroupDocs.Redaction के साथ .net में कस्टम लॉगिंग क्यों उपयोग करें?

अपने रिडैक्शन प्रक्रिया को विस्तृत, खोज योग्य लॉग्स से लोड करें जो नियामक ऑडिट को पूरा करते हैं और समस्या निवारण को तेज़ बनाते हैं। GroupDocs.Redaction 70+ इनपुट और आउटपुट फ़ॉर्मेट का समर्थन करता है और पूरे फ़ाइल को मेमोरी में लोड किए बिना 500 पृष्ठों तक के दस्तावेज़ों को प्रोसेस कर सकता है, इसलिए एक अच्छी तरह से डिज़ाइन किया गया लॉगर न्यूनतम ओवरहेड जोड़ता है जबकि अमूल्य दृश्यता प्रदान करता है।

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

• GroupDocs.Redaction for .NET स्थापित है (नीचे Installation सेक्शन देखें)।
• एक .NET विकास वातावरण (Visual Studio, VS Code, या .NET CLI)।
• बेसिक C# ज्ञान और फ़ाइल स्ट्रीम्स की परिचितता।

स्थापना

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI
“GroupDocs.Redaction” को खोजें और नवीनतम संस्करण स्थापित करें।

लाइसेंस प्राप्ति

• Free trial: अस्थायी लाइसेंस के साथ API का परीक्षण करें।
• Temporary license: सीमित अवधि के लिए पूर्ण फीचर एक्सेस प्राप्त करें।
• Purchase: उत्पादन डिप्लॉयमेंट के लिए स्थायी लाइसेंस प्राप्त करें।

स्टेप‑बाय‑स्टेप गाइड

.NET Core में कस्टम लॉगर कैसे लागू करें?

CustomLogger क्लास को अपने .NET Core प्रोजेक्ट में लोड करें और इसे RedactorSettings से जोड़ें। लॉगर .NET Framework, .NET 5, और .NET 6 पर भी समान रूप से काम करता है, इसलिए आप सभी प्लेटफ़ॉर्म पर एक ही कोड साझा कर सकते हैं।

स्टेप 1: कस्टम लॉगर क्लास परिभाषित करें (log warnings c#)

The CustomLogger क्लास ILogger को लागू करती है।
CustomLogger एक यूज़र‑डिफाइंड क्लास है जो ILogger इंटरफ़ेस को लागू करके रिडैक्शन इवेंट्स को कैप्चर करती है।

using System;
using GroupDocs.Redaction;

class CustomLogger : ILogger
{
    public bool HasErrors { get; private set; }

    // Log errors encountered during processing.
    public void LogError(string message)
    {
        Console.WriteLine("Error: " + message);
        HasErrors = true;
    }

    // Log warnings that may not be critical but need attention.
    public void LogWarning(string message)
    {
        Console.WriteLine("Warning: " + message);
    }

    // Log informational messages for tracking normal operations.
    public void LogInfo(string message)
    {
        Console.WriteLine("Info: " + message);
    }
}

Definition anchor: CustomLogger ILogger इंटरफ़ेस का एक यूज़र‑डिफाइंड इम्प्लीमेंटेशन है जो रिडैक्शन इवेंट्स को रिकॉर्ड करता है।
Explanation: HasErrors फ़्लैग आपको यह तय करने में मदद करता है कि प्रोसेसिंग जारी रखनी है या नहीं। तीन मेथड्स उन तीन लॉग लेवल्स से मेल खाते हैं जिनकी आपको अधिकांश रिडैक्शन परिदृश्यों में आवश्यकता होगी।

स्टेप 2: फ़ाइल पाथ तैयार करें और स्रोत दस्तावेज़ खोलें

string sourceFile = Utils.PrepareOutputDirectory("YOUR_DOCUMENT_DIRECTORY");
string outputFile = Utils.GetOutputFile(sourceFile);

Definition anchor: Redactor GroupDocs.Redaction में मुख्य क्लास है जो PDF दस्तावेज़ पर रिडैक्शन ऑपरेशन करता है।
Why this matters: यूटिलिटी मेथड्स का उपयोग करने से आपका कोड साफ़ रहता है और यह सुनिश्चित करता है कि आउटपुट फ़ोल्डर मौजूद हो, इससे पहले कि आप रिडैक्टेड दस्तावेज़ सहेजें करने का प्रयास करें।

स्टेप 3: कस्टम लॉगर का उपयोग करते हुए रिडैक्शन लागू करें

using (Stream stream = File.Open(sourceFile, FileMode.Open, FileAccess.ReadWrite))
{
    var logger = new CustomLogger();
    
    using (Redactor redactor = new Redactor(stream, new LoadOptions(), new RedactorSettings(logger)))
    {
        // Apply a redaction to the document.
        redactor.Apply(new DeleteAnnotationRedaction());
        
        if (!logger.HasErrors)
        {
            using (Stream streamOut = File.Open(outputFile, FileMode.OpenOrCreate, FileAccess.ReadWrite))
            {
                // Save changes without rasterizing the output.
                redactor.Save(streamOut, new Options.RasterizationOptions { Enabled = false });
            }
        }
    }
}

Direct answer: रिडैक्शन वर्कफ़्लो Redactor इंस्टेंस को RedactorSettings(logger) के साथ बनाकर शुरू होता है, फिर रिडैक्शन ऑब्जेक्ट्स लागू करता है, logger.HasErrors की जाँच करता है, और अंत में रास्टराइज़ेशन निष्क्रिय करके redactor.Save को कॉल करता है। यह पैटर्न सुनिश्चित करता है कि हर चरण लॉग हो और जब कोई त्रुटि न हो तो ही आप एक साफ़ दस्तावेज़ सहेजें।

Explanation:

1. Redactor को RedactorSettings(logger) के साथ इंस्टैंशिएट किया जाता है, जिससे आपका CustomLogger जुड़ता है।
2. रिडैक्शन लागू करने के बाद, कोड logger.HasErrors की जाँच करता है। यदि कोई त्रुटि नहीं हुई, तो दस्तावेज़ सहेजा जाता है—रास्टराइज़ेशन के बिना रिडैक्टेड दस्तावेज़ सहेजें लॉजिक को दर्शाता है।

सामान्य समस्याएँ और ट्रबलशूटिंग

• Missing log output: सुनिश्चित करें कि प्रत्येक Log* मेथड सही ढंग से ओवरराइड किया गया है।
• File access exceptions: सुनिश्चित करें कि एप्लिकेशन के पास स्रोत और आउटपुट पाथ दोनों के लिए पढ़ने/लिखने की अनुमति है।
• Logger not wired: RedactorSettings(logger) पैरामीटर आवश्यक है; इसे छोड़ने से कस्टम लॉगिंग निष्क्रिय हो जाती है।

व्यावहारिक अनुप्रयोग

1. Compliance reporting: ऑडिट ट्रेल्स के लिए लॉग एंट्रीज़ को CSV या डेटाबेस में एक्सपोर्ट करें।
2. Error tracking: LogError आउटपुट स्कैन करके समस्याग्रस्त फ़ाइलों को जल्दी ढूँढें।
3. Workflow automation: जब LogWarning कॉल किया जाए तो डाउनस्ट्रीम प्रोसेसेस (जैसे, कॉम्प्लायंस अधिकारी को सूचित करना) ट्रिगर करें।

प्रदर्शन संबंधी विचार

• Dispose streams promptly मेमोरी मुक्त करने के लिए स्ट्रीम्स को तुरंत डिस्पोज़ करें, विशेष रूप से बड़े बैच प्रोसेसिंग में।
• Monitor CPU & memory बड़े पैमाने पर रिडैक्शन के दौरान; लॉगर सिंक्रनाइज़ेशन का ध्यान रखते हुए समानांतर में दस्तावेज़ प्रोसेस करने पर विचार करें।
• Stay updated: GroupDocs.Redaction के नए संस्करण अक्सर प्रदर्शन अनुकूलन और अतिरिक्त लॉगिंग हुक्स शामिल करते हैं।

निष्कर्ष

custom logger c# को लागू करके, आप रिडैक्शन पाइपलाइन के हर चरण में सूक्ष्म अंतर्दृष्टि प्राप्त करते हैं, जिससे अनुपालन मानकों को पूरा करना और समस्याओं का डिबग करना आसान हो जाता है। यहाँ दिखाया गया तरीका GroupDocs.Redaction for .NET के साथ सहजता से काम करता है और इसे किसी भी .NET लॉगिंग फ्रेमवर्क के साथ एकीकृत करने के लिए विस्तारित किया जा सकता है।

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

Q: GroupDocs.Redaction के साथ कस्टम लॉगिंग का उद्देश्य क्या है?
A: कस्टम लॉगिंग विस्तृत रिडैक्शन इवेंट्स को कैप्चर करती है, ऑडिट आवश्यकताओं को पूरा करती है, और रीयल‑टाइम में त्रुटियों और चेतावनियों को उजागर करके ट्रबलशूटिंग को सरल बनाती है।

Q: कस्टम लॉगर का उपयोग करके त्रुटियों को कैसे संभालें?
A: अपने CustomLogger क्लास में LogError को इम्प्लीमेंट करें; HasErrors फ़्लैग आपको महत्वपूर्ण समस्या मिलने पर प्रोसेसिंग को रोकने देता है।

Q: क्या कस्टम लॉगिंग को अन्य सिस्टम्स के साथ एकीकृत किया जा सकता है?
A: हाँ—लॉगर मेथड्स को विस्तारित करके आप लॉग संदेशों को CRM, ERP, या सेंट्रलाइज़्ड मॉनिटरिंग टूल्स में फॉरवर्ड कर सकते हैं।

Q: कस्टम लॉगिंग को लागू करते समय सामान्य समस्याएँ क्या हैं?
A: मेथड ओवरराइड्स का न होना, RedactorSettings(logger) पास करना भूल जाना, और अपर्याप्त फ़ाइल अनुमतियाँ सबसे आम समस्याएँ हैं।

Q: कस्टम लॉगिंग दस्तावेज़ रिडैक्शन वर्कफ़्लो को कैसे सुधारती है?
A: विस्तृत लॉग्स रीयल‑टाइम दृश्यता प्रदान करते हैं, डिबगिंग को सहज बनाते हैं, और GDPR और HIPAA जैसे नियमों द्वारा आवश्यक ऑडिट ट्रेल्स उत्पन्न करते हैं।

संसाधन

• Documentation: GroupDocs.Redaction .NET दस्तावेज़ीकरण
• API reference: GroupDocs.Redaction API रेफ़रेंस
• Download: GroupDocs.Redaction for .NET डाउनलोड

अंतिम अपडेट: 2026-10-01
परीक्षण किया गया: GroupDocs.Redaction 23.11 for .NET
लेखक: GroupDocs

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

• GroupDocs.Redaction for .NET के साथ दस्तावेज़ लोड कैसे करें
• GroupDocs.Redaction .NET के साथ रिडैक्टेड दस्तावेज़ एक्सपोर्ट कैसे करें
• GroupDocs.Redaction .NET का उपयोग करके दस्तावेज़ रिडैक्शन लागू करें: एक स्टेप‑बाय‑स्टेप गाइड