GroupDocs ile .NET’te Belge Kırpma ve Arama Dizini Yönetimini Ustalıkla Öğrenin

Giriş

Eğer belge kırpma yaparken aynı zamanda belgelerin aranabilir kalmasını istiyorsanız, doğru yere geldiniz. Bu öğretici, GroupDocs.Redaction ve GroupDocs.Search kombinasyonunu kullanarak hassas verileri güvenli bir şekilde gizlemenizi ve ardından belgeleri dizine eklemenizi hızlı geri getirme için anlatır. Sonunda arama performansını optimize etme, C# ile PDF dosyalarını kırpma ve verilerinizle ölçeklenebilen sağlam bir indeksleme hattı oluşturma konularını anlayacaksınız.

Hızlı Yanıtlar

  • C#’ta bir PDF’yi nasıl kırparım? RedactionEngine‘i kullanarak dosyayı yükleyin, kırpma alanlarını tanımlayın ve Save çağırın.
  • Hangi sınıf bir arama dizini oluşturur? GroupDocs.Search’ten Index sınıfı tüm indeksleme işlemlerini yönetir.
  • Tüm dizini yeniden oluşturmadan yeni dosyalar ekleyebilir miyim? Evet—artımlı güncellemeler için Index.AddDocument çağırın.
  • Kırpma arama sonuçlarını etkiler mi? Kırpılmış içerik indeks dışına çıkar, aramaları temiz tutar.
  • Hangi .NET sürümleri destekleniyor? .NET Framework 4.6.1+, .NET Core 3.1+ ve .NET 5/6.

“Belge kırpma” nedir?

“Belge kırpma”, dosyalardan gizli bilgileri programlı olarak kaldırma veya maskeleme sürecine denir; böylece gizlenen veriler geri getirilemez veya görüntülenemez. Kırpma, veri sızıntısının önlenmesi gereken uyumluluk, gizlilik ve yasal iş akışları için esastır.

Neden kırpma ve arama için GroupDocs kullanmalı?

GroupDocs, 50+ dosya formatını (PDF, DOCX, PPTX ve görüntü türleri dahil) destekler ve tüm dosyayı belleğe yüklemeden çok sayfalı belgeleri işleyebilir; bu sayede genel kütüphanelere göre %30’a kadar daha hızlı indeksleme sağlar. Birleştirilmiş Redaction + Search paketi, C# PDF’leri kırpmanıza ve temiz sürümü hemen indekslemenize olanak tanır, ayrı bir ön işleme adımına gerek kalmaz.

Ön Koşullar

  • GroupDocs.Search .NET için (v20.11 veya sonrası)
  • GroupDocs.Redaction .NET için (v20.10 veya sonrası)
  • Visual Studio 2017 or newer
  • .NET Framework 4.6.1 or later (or .NET Core 3.1+)

Bilgi Ön Koşulları

Temel C# sözdizimi, proje referansları ve dosya sistemi işlemlerine aşina olmalısınız.

.NET için GroupDocs.Redaction Kurulumu

Kütüphaneleri Kurun

.NET CLI
dotnet add package, projenize bir NuGet paketi ekleyen .NET CLI komutudur.

dotnet add package GroupDocs.Redaction

Package Manager
Install-Package, NuGet Package Manager Console tarafından kütüphane eklemek için kullanılan PowerShell komutudur.

Install-Package GroupDocs.Redaction

NuGet Package Manager UI
“GroupDocs.Redaction”ı arayın ve en son kararlı sürümü indirmek için Install (Yükle) düğmesine tıklayın.

Lisans Alımı

  • Free Trial – 30 gün tam özellikli deneme.
  • Temporary License – değerlendirme için 15 günlük genişletilmiş erişim.
  • Purchase – kalıcı üretim lisansı.

Temel Başlatma

RedactionEngine, kırpma sonrası belgeleri yüklemek, değiştirmek ve kaydetmek için kullanılan temel sınıftır.

using GroupDocs.Redaction;

RedactorSettings settings = new RedactorSettings();
// Further configuration and initialization...

Uygulama Rehberi

Çözümü üç mantıksal bölüme ayıralım: bir dizin oluşturma, belgeleri (kırpılmış olanlar dahil) ekleme ve dizini arama.

GroupDocs.Search ile bir arama dizini nasıl oluşturulur?

Index, GroupDocs.Search içinde aranabilir bir dizini temsil eden ana sınıftır. Diskteki bir klasöre işaret ederek bir Index örneği yükler veya oluşturursunuz; kütüphane ardından tüm iç dosyaları sizin için yönetir. Bu adım, arama performansını optimize etme için temeldir çünkü iyi yapılandırılmış bir dizin sorgu gecikmesini azaltır.

using GroupDocs.Search;

string indexFolder = "YOUR_DOCUMENT_DIRECTORY/HelloWorldIndex";

Açıklama: Kod, dizin dosyalarını tutacak klasörü tanımlar. Ayrı bir klasör kullanmak, dizin verilerini kaynak belgelerinizden izole eder.

Index index = new Index(indexFolder);

Açıklama: Index nesnesi oluşturulduğunda, yol boşsa yeni bir dizin oluşturur, aksi takdirde mevcut dizini açar.

Kırpma sonrası belgeler nasıl dizine eklenir?

İlk olarak, gizli bölümleri kırpın, ardından temiz dosyayı dizine ekleyin. Bu iki adımlı akış, yalnızca güvenli içeriğin aranabilir olmasını garanti eder.

Kaynak klasörü tanımlayın

documentsFolder, orijinal PDF’lerinizin bulunduğu yoldur.

string documentsFolder = "YOUR_DOCUMENT_DIRECTORY/HelloWorldDocuments";

AddDocument, Index sınıfının tek bir belgeyi dizine ekleyen metodudur.

index.Add(documentsFolder);

Oluşturulan dizinde nasıl arama yapılır?

Bir sorgu dizesi belirleyin, aramayı çalıştırın ve sonuçlar arasında döngü yapın. API, sayfa numaralarını, alıntıları ve belge tanımlayıcılarını döndürür; böylece sonuçları bir UI’da sunmak kolaylaşır.

SearchResult, sorgu tarafından döndürülen sonuçları, eşleşen belgeleri ve alıntıları tutar.

string query = "Lorem";

SearchResult result = index.Search(query);

Pratik Uygulamalar

Bu yetenekler gerçek dünya problemlerini çözer:

  1. Legal Document Management – Vaka dosyalarını indekslemeden önce müşteri adlarını kırpın, gizliliği sağlayın ve avukatların hâlâ dava hukukunu aramasına izin verin.
  2. Healthcare Records – Medikal PDF’lerden hasta kimlik bilgilerini çıkarın, ardından temizlenmiş sürümleri hızlı denetim sorguları için indeksleyin.
  3. Corporate Compliance – Finansal tabloların kırpılmasını otomatikleştirin ve temiz sürümleri iç soruşturmalar için hemen aranabilir hâle getirin.

Performans Düşünceleri

Büyük hacimlerle çalışırken arama performansını optimize etmek için:

  • İndekslemeyi arka plan işi olarak çalıştırın ve değişiklikleri toplu olarak işleyin.
  • Index nesnelerini zamanında serbest bırakın, yönetilmeyen kaynakları boşaltın.
  • Bellek kullanımını izleyin; GroupDocs.Search verileri akış olarak işler ve hiçbir zaman tüm belgeyi RAM’e yüklemez.
  • Dizini sık ve hızlı sorgulanabilir tutmak için periyodik dizin birleştirmeleri planlayın.

Yaygın Sorunlar ve Çözümler

SorunÇözüm
Büyük PDF’lerde bellek yetersizliği hatalarıRedactionEngine‘i, akış modunu etkinleştiren RedactionOptions ile kullanın.
Arama kırpılmış terimleri döndürüyorKırpmayı Index.AddDocument çağırmadan önce çalıştırdığınızdan emin olun.
Desteklenmeyen dosya formatıDosya uzantısının 50+ desteklenen format arasında olduğundan emin olun; desteklenmeyen dosyaları önce PDF’ye dönüştürün.
Lisans tanınmıyorLisans dosyasını uygulama kök dizinine koyun ve herhangi bir API kullanımından önce License.SetLicense("license.json") çağırın.

Sık Sorulan Sorular

S: PDF C# dosyalarını önce dönüştürmeden doğrudan kırpabilir miyim?
C: Evet—RedactionEngine PDF akışlarıyla yerel olarak çalışır, böylece bir PDF’yi yükleyebilir, kırpma nesnelerini uygulayabilir ve sonucu herhangi bir format dönüşümü yapmadan kaydedebilirsiniz.

S: Belgeleri dizine eklemek arama hızını nasıl etkiler?
C: Artımlı indeksleme yalnızca yeni dosyaları ekler, dizin boyutunu sabit tutar ve tipik iş yükleri için sorgu gecikmesini 200 ms’nin altında tutar.

S: Otomatik yeniden indekslemeyi zamanlamak mümkün mü?
C: Kesinlikle. Bir Windows Service veya Azure Function kullanarak belirli aralıklarla Index.AddDocument çağırabilir ve yeni yüklenen dosyaları dizine ekleyebilirsiniz.

S: Kırpma gizli verileri kalıcı olarak kaldırır mı?
C: Evet—kırpma, orijinal baytları üzerine yazar, böylece veri adli araçlarla bile kurtarılamaz.

S: Hangi .NET sürümleri tam olarak destekleniyor?
C: Hem .NET Framework 4.6.1+ hem de .NET Core 3.1+ (.NET 5/6 dahil) resmi olarak desteklenmektedir.

Kaynaklar

Son Güncelleme: 2026-07-02
Test Edilen: GroupDocs.Search 21.2 ve GroupDocs.Redaction 21.1 for .NET
Yazar: GroupDocs

İlgili Eğitimler