GroupDocs.Redaction için .NET’te özel logger c# uygulama

Belge redaksiyonlarını verimli bir şekilde yönetmek kritik öneme sahiptir, özellikle hassas bilgilerle çalışırken. Bu rehberde GroupDocs.Redaction for .NET ile özel bir logger c# nasıl uygulanır öğrenecek, kayıt, hata yönetimi ve denetim izleri üzerinde tam kontrol elde edeceksiniz. Eğitim sonunda uyarıları, hataları ve bilgi mesajlarını yakalayabilecek, logger’ı mevcut .NET kayıt çerçeveleriyle entegre edebilecek ve redakte edilmiş belgeyi rasterleştirme olmadan kaydedebileceksiniz.

Hızlı cevaplar

  • Özel bir logger c# ne yapar? Redaksiyon sırasında hataları, uyarıları ve bilgi mesajlarını yakalar, arama yapılabilir bir denetim izi sağlar.
  • ILogger arayüzünü hangi kütüphane sağlar? GroupDocs.Redaction for .NET ILogger arayüzünü sağlar.
  • Rasterleştirme olmadan redakte edilmiş belgeyi kaydedebilir miyim? Evet – redactor.Save(..., new Options.RasterizationOptions { Enabled = false }) çağırın.
  • Üretim kullanımı için lisansa ihtiyacım var mı? Üretim için tam lisans gereklidir; değerlendirme için bir deneme lisansı mevcuttur.
  • Bu yaklaşım .NET Core / .NET 6+ ile uyumlu mu? Kesinlikle – aynı API .NET Framework, .NET Core, .NET 5 ve .NET 6’da çalışır.

Özel bir logger c# nedir?

Bir custom logger c#, GroupDocs.Redaction tarafından sağlanan ILogger arayüzünü uygulayan bir sınıftır. Günlük mesajlarını istediğiniz yere—konsol, dosya, veritabanı veya harici izleme sistemleri—yönlendirmenizi sağlar ve redaksiyon iş akışının genel bir görünümünü sunar.

GroupDocs.Redaction ile .NET’te özel kayıt neden kullanılmalı?

Redaksiyon sürecinizi ayrıntılı, aranabilir günlüklerle yükleyin; bu, denetim gereksinimlerini karşılar ve sorun giderme süresini hızlandırır. GroupDocs.Redaction 70+ giriş ve çıkış formatını destekler ve tüm dosyayı belleğe yüklemeden 500 sayfaya kadar belge işleyebilir, bu yüzden iyi tasarlanmış bir logger, önemsiz bir ek yük getirirken paha biçilmez bir görünürlük sağlar.

Önkoşullar

  • GroupDocs.Redaction for .NET yüklü (aşağıdaki Kurulum bölümüne bakın).
  • Bir .NET geliştirme ortamı (Visual Studio, VS Code veya .NET CLI).
  • Temel C# bilgisi ve dosya akışlarına aşinalık.

Kurulum

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI
“GroupDocs.Redaction” ifadesini arayın ve en son sürümü yükleyin.

Lisans edinimi

  • Ücretsiz deneme: API’yi geçici bir lisansla test edin.
  • Geçici lisans: Sınırlı bir süre için tam özellik erişimi alın.
  • Satın alma: Üretim dağıtımları için kalıcı bir lisans edinin.

Adım‑adım kılavuz

.NET Core’da özel logger nasıl uygulanır?

CustomLogger sınıfını .NET Core projenize yükleyin ve RedactorSettings ile bağlayın. Logger, .NET Framework, .NET 5 ve .NET 6’da aynı şekilde çalışır, böylece tüm platformlarda aynı kodu paylaşabilirsiniz.

Adım 1: Özel bir logger sınıfı tanımlayın (log warnings c#)

CustomLogger sınıfı ILogger arayüzünü uygular.
CustomLogger, redaksiyon olaylarını yakalamak için ILogger arayüzünü uygulayan kullanıcı tanımlı bir sınıftır.

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);
    }
}

Tanım bağlantısı: CustomLogger, redaksiyon olaylarını kaydeden ILogger arayüzünün kullanıcı tanımlı bir uygulamasıdır.
Açıklama: HasErrors bayrağı, işleme devam edip etmeyeceğinize karar vermenize yardımcı olur. Üç yöntem, çoğu redaksiyon senaryosunda ihtiyaç duyacağınız üç günlük seviyesine karşılık gelir.

Adım 2: Dosya yollarını hazırlayın ve kaynak belgeyi açın

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

Tanım bağlantısı: Redactor, PDF belgesi üzerinde redaksiyon işlemleri yapan GroupDocs.Redaction’ın temel sınıfıdır.
Neden önemli: Yardımcı metodları kullanmak kodunuzu temiz tutar ve redakte edilmiş belgeyi kaydet işlemine geçmeden önce çıkış klasörünün var olduğundan emin olur.

Adım 3: Özel logger’ı kullanarak redaksiyonları uygulayın

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 });
            }
        }
    }
}

Doğrudan cevap: Redaksiyon iş akışı, RedactorSettings(logger) ile bir Redactor örneği oluşturularak başlar, ardından redaksiyon nesneleri uygulanır, logger.HasErrors kontrol edilir ve son olarak rasterleştirme devre dışı bırakılarak redactor.Save çağrılır. Bu desen, her adımın kaydedildiğinden ve hatasız bir belge yalnızca hatasız olduğunda kalıcı olarak kaydedildiğinden emin olur.

Açıklama:

  1. Redactor, RedactorSettings(logger) ile örneklenir ve CustomLogger‘ınız bağlanır.
  2. Bir redaksiyon uygulandıktan sonra kod logger.HasErrors kontrol eder. Hata yoksa belge kaydedilir—redakte edilmiş belgeyi kaydet mantığını rasterleştirme olmadan gösterir.

Yaygın tuzaklar ve sorun giderme

  • Eksik günlük çıktısı: Her Log* metodunun doğru şekilde geçersiz kılındığını doğrulayın.
  • Dosya erişim istisnaları: Uygulamanın hem kaynak hem de çıktı yolları için okuma/yazma izinlerine sahip olduğundan emin olun.
  • Logger bağlanmamış: RedactorSettings(logger) parametresi gereklidir; atlanması özel kaydı devre dışı bırakır.

Pratik uygulamalar

  1. Uyumluluk raporlaması: Günlük girişlerini denetim izleri için CSV veya veritabanına dışa aktarın.
  2. Hata takibi: LogError çıktısını tarayarak sorunlu dosyaları hızlıca bulun.
  3. İş akışı otomasyonu: LogWarning tetiklendiğinde sonraki süreçleri (ör. uyumluluk sorumlusuna bildirim) başlatın.

Performans değerlendirmeleri

  • Akışları hemen serbest bırakın belleği boşaltmak için, özellikle büyük toplu işlemlerde.
  • CPU ve belleği izleyin toplu redaksiyon sırasında; logger senkronizasyonuna dikkat ederek belgeleri paralel işleme almayı düşünün.
  • Güncel kalın: GroupDocs.Redaction’ın yeni sürümleri genellikle performans iyileştirmeleri ve ek günlük kancaları içerir.

Sonuç

custom logger c# uygulayarak, redaksiyon hattının her adımına ayrıntılı bir bakış elde eder, uyumluluk standartlarını karşılamayı ve sorunları ayıklamayı kolaylaştırırsınız. Burada gösterilen yaklaşım, GroupDocs.Redaction for .NET ile sorunsuz çalışır ve zaten kullandığınız herhangi bir .NET kayıt çerçevesiyle entegrasyon için genişletilebilir.

Sıkça sorulan sorular

S: GroupDocs.Redaction ile özel kaydın amacı nedir?
C: Özel kayıt, ayrıntılı redaksiyon olaylarını yakalar, denetim gereksinimlerini karşılar ve hataları ve uyarıları gerçek zamanlı olarak göstererek sorun giderme sürecini basitleştirir.

S: Özel bir logger kullanarak hataları nasıl yönetirim?
C: CustomLogger sınıfınızda LogError metodunu uygulayın; HasErrors bayrağı kritik bir sorun tespit edildiğinde işleme iptal etmenizi sağlar.

S: Özel kayıt diğer sistemlerle entegre edilebilir mi?
C: Evet—logger metodlarını genişleterek günlük mesajlarını CRM, ERP veya merkezi izleme araçlarına yönlendirebilirsiniz.

S: Özel kayıt uygularken yaygın tuzaklar nelerdir?
C: Metod geçersiz kılmalarının eksik olması, RedactorSettings(logger) parametresini geçmeyi unutmak ve yetersiz dosya izinleri en sık karşılaşılan sorunlardır.

S: Özel kayıt belge redaksiyon iş akışlarını nasıl iyileştirir?
C: Ayrıntılı günlükler gerçek zamanlı görünürlük sağlar, hata ayıklamayı hızlandırır ve GDPR ve HIPAA gibi düzenlemeler tarafından talep edilen denetim izlerini oluşturur.

Kaynaklar

Last updated: 2026-10-01
Tested with: GroupDocs.Redaction 23.11 for .NET
Author: GroupDocs

İlgili Eğitimler