Aspose.GroupDocs Redaction ile .NET Belge Dizini Oluşturma

Büyük dosya koleksiyonlarını yönetmek, klasörlerinizi düzenli tutmak and arama dizininizi güncel tutacak güvenilir bir yolunuz yoksa hızla bir kabusa dönüşebilir. Bu öğreticide, GroupDocs.Redaction for .NET kullanarak create document index .net nasıl yapılacağını öğrenecek, dizin hazırlığı, dizin oluşturma, belge yeniden adlandırma ve dizin güncellemelerini kapsayacaksınız. Sonunda, birkaç PDF’den binlerce yasal veya destek belgesine kadar ölçeklenebilen tekrarlanabilir bir iş akışına sahip olacaksınız.

Hızlı Yanıtlar

  • Hangi kütüphane gerekiyor? GroupDocs.Redaction for .NET (latest NuGet version).
  • Hangi .NET sürümleri destekleniyor? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6+.
  • Kaç format indekslenebilir? Over 50 input formats — including PDF, DOCX, XLSX, PPTX, and common image types.
  • İndeksi bozmadan dosyaları yeniden adlandırabilir miyim? Yes—use the built‑in Rename method and then call NotifyIndex.
  • Üretim için lisans gerekli mi? A valid GroupDocs.Redaction license is mandatory for production use.

“Create Document Index .NET” Nedir?

Create document index .net .NET uygulamasında dosyaların aranabilir bir kataloğunu oluşturma sürecine referans eder; her giriş dosya adı, yol ve içerik parçacıkları gibi meta verileri saklar. Bu dizin, her seferinde tüm dosya sistemini taramadan hızlı aramalar sağlar.

Neden GroupDocs.Redaction İndeksleme İçin Kullanılmalı?

GroupDocs.Redaction yalnızca hassas içeriği kırpmakla kalmaz, aynı zamanda standart 8‑core sunucuda dakikada 10.000 belgeye kadar işleyebilen yüksek performanslı bir indeksleme motoru sunar ve çoğu iş yükü için bellek kullanımını 200 MB altında tutar. API’si dosya sistemi tuhaflıklarını soyutlayarak dizinleri yönetmenin ve indeksleri senkronize tutmanın tutarlı bir yolunu sağlar.

Önkoşullar

  • GroupDocs.Redaction NuGet paketi yüklü (en son stabil sürüm).
  • Visual Studio 2022 veya herhangi bir .NET‑uyumlu IDE.
  • Temel C# bilgisi (dosya I/O, istisna yönetimi).

Gerekli Kütüphaneler, Sürümler ve Bağımlılıklar

  • GroupDocs.Redaction ≥ 23.10 (.NET Standard 2.0 ve .NET 5+ destekler).
  • Opsiyonel: Microsoft.Extensions.Logging detaylı tanılamalar için.

Ortam Kurulum Gereksinimleri

Paketi aşağıdaki komutlardan biriyle ekleyin (gerçek kod bloklarını temsil eden yer tutucuları değiştirmeyin):

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

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

Lisans Edinme Adımları

  1. Free Trial – GroupDocs portalından 30‑günlük deneme alın.
  2. Temporary License – Uzun vadeli test için geçici bir anahtar isteyin.
  3. Purchase – Tam işlevselliği açmak için üretim lisansı edinin.

Temiz Çalışma Dizini Nasıl Hazırlanır?

Hedef klasörünüzü yükleyin, rastgele geçici dosyaları silin ve indekslemek istediğiniz kaynak belgeleri kopyalayın. Bu hazırlık adımı, indeksleme sırasında “dosya kullanımda” hatalarını ortadan kaldırır ve indeks oluşturucunun belirli bir dosya seti üzerinde çalışmasını sağlar. Temiz bir ortam sağlayarak yanlış pozitifleri azaltır, izin sorunlarından kaçınırsınız ve genel indeksleme performansını artırırsınız.

Dizini Temizle

DirectoryCleaner sınıfı, indekslemeye engel olabilecek kalıntı dosyaları (örn., *.tmp, *.bak) kaldırır.

using GroupDocs.Search.Common;
using System.IO;

string documentFolder = "YOUR_DOCUMENT_DIRECTORY/";

// Ensure the directory is empty before use
Utils.CleanDirectory(documentFolder);

Gerekli Dosyaları Kopyala

FilePreparer kaynak PDF’leri, DOCX’leri ve görüntüleri çalışma klasörüne kopyalar, orijinal klasör hiyerarşisini korur.

// Copy essential documents to the target directory from a source path
Utils.CopyFiles(Utils.DocumentsPath, documentFolder);

Dizini Nasıl Oluşturursunuz?

Index, aranabilir bir belge koleksiyonunu temsil eder ve temel depolama yapılarını yönetir.

Index nesnesini oluşturun, temiz dizininize yönlendirin ve Build metodunu çağırın. Bu işlem her dosyayı tarar, aranabilir metni çıkarır ve verimli bir ikili yapıda depolar. Oluşturucu ayrıca dosya yolları ve zaman damgaları gibi meta verileri kaydeder, hızlı aramaları ve değişmeyen belgeleri yeniden işlemeye gerek kalmadan artımlı güncellemeleri mümkün kılar.

Dizini Oluştur

Index sınıfı, aranabilir bir belge koleksiyonunu temsil eden temel bileşendir.

using GroupDocs.Search;

string indexFolder = "YOUR_DOCUMENT_DIRECTORY/Index/";
Index index = new Index(indexFolder); // Create the index

// Add documents from your directory to the index
index.Add("YOUR_DOCUMENT_DIRECTORY/Documents/");

Belgeleri Yeniden Adlandırma ve İndeksi Bildirme Nasıl Yapılır?

DocumentRenamer, dosyaları indeks bütünlüğünü koruyarak yeniden adlandırmak için yardımcı araçlar sağlar.

DocumentRenamer.RenameAndNotify diskteki dosyayı yeniden adlandırır ve ardından katalogun doğru kalmasını sağlamak için Index.UpdateEntry metodunu çağırır. Yeniden adlandırma ve anlık indeks bildirimi tek bir işlemde yapılarak eski referanslardan kaçınılır ve sonraki aramaların yeni dosya adını döndürmesi sağlanır. Bu yöntem ayrıca denetim izleri için işlemi kaydeder.

using System;
using GroupDocs.Search;
using System.IO;

string oldDocumentPath = "YOUR_DOCUMENT_DIRECTORY/Documents/Lorem ipsum.txt";
string newDocumentPath = "YOUR_DOCUMENT_DIRECTORY/Documents/Lorem ipsum renamed.txt";

// Rename the file by moving it to a new path
File.Move(oldDocumentPath, newDocumentPath);

// Notify the index about this change\NSNotification notification = Notification.CreateRenameNotification(oldDocumentPath, newDocumentPath);
Index indexForNotify = new Index(indexFolder);
bool result = indexForNotify.Notify(notification); 
Console.WriteLine($"Successful rename: {result}");

Değişikliklerden Sonra Mevcut İndeksi Nasıl Güncelleriz?

Index.Refresh, mevcut bir indekse tamamen yeniden inşa etmeden artımlı değişiklikler uygular.

Index.Refresh sadece delta (yeni veya değişmiş dosyalar) işleyerek tam yeniden inşa ile karşılaştırıldığında CPU yükünü %85’e kadar azaltır. Metod çalışma dizinini tarar, değiştirilmiş zaman damgalarına sahip dosyaları belirler ve dokunulmamış belgeleri koruyarak girişlerini günceller. Bu yaklaşım bakım pencerelerini büyük ölçüde kısaltır ve arama deneyimini duyarlı tutar.

using GroupDocs.Search;

Index indexToUpdate = new Index(indexFolder);

// Updates metadata without reindexing the entire document
indexToUpdate.Update();

Yaygın Kullanım Senaryoları

  1. Legal Document Management – Sözleşmeleri, özetleri ve dava dosyalarını anında erişim için indeksleyin.
  2. Digital Library Systems – Binlerce e-kitap ve araştırma makalesi üzerinde gerçek zamanlı arama sağlayın.
  3. Enterprise Content Management – Otomatik olarak adlandırma kurallarını yansıtan denetim‑hazır dizinleri sürdürün.
  4. Customer Support Archives – Önceki biletleri, PDF’leri ve bilgi tabanı makalelerini hızlıca bulun.

Performans Düşünceleri

  • Batch Updates – Aşırı I/O dalgalanmalarını önlemek için değişiklikleri ≤ 500 dosya gruplarına ayırın.
  • Memory Management – Her işlemden sonra Index nesnesini serbest bırakın; kütüphane yerel tamponları otomatik olarak serbest bırakır.
  • Parallel Scanning – IndexOptions.EnableParallelProcessing özelliğini etkinleştirerek çok çekirdekli CPU’ları kullanın, 8 çekirdekli bir makinede 3×’e kadar hız artışı elde edin.

Sıkça Sorulan Sorular

Q: GroupDocs.Redaction’ın temel kullanımı nedir?
A: PDF’lerden, DOCX’lerden ve görüntülerden hassas içeriği kırpar, aynı zamanda güçlü dizin ve indeksleme yardımcı programları sunar.

Q: Aynı anda birden fazla dizini yönetebilir miyim?
A: Evet—her klasör için ayrı Index örnekleri oluşturun ve paralel olarak çalıştırın.

Q: İndeksleme sırasında hataları nasıl ele alırım?
A: Index.Build ve Index.Refresh metodlarını try‑catch bloklarıyla sarın; sorun giderme için RedactionException detaylarını kaydedin.

Q: GroupDocs.Redaction için sistem gereksinimleri nelerdir?
A: .NET Framework 4.6+ veya .NET Core 3.1+ çalışma zamanı, en az 2 GB RAM ve geçici tamponlar için 500 MB boş disk alanı.

Q: Büyük belge setleri için indeks performansını nasıl optimize edebilirim?
A: Düzenli olarak Index.Refresh çağırın, paralel işleme etkinleştirin ve bellek tüketimini kontrol altında tutmak için toplu işlem boyutlarını sınırlayın.

Ek Kaynaklar

Son Güncelleme: 2026-06-22
Test Edilen: GroupDocs.Redaction 23.10 for .NET
Yazar: GroupDocs

using GroupDocs.Redaction;

// Initialize the Redactor object with your document path
var redactor = new Redactor("YOUR_DOCUMENT_PATH");

İlgili Öğreticiler