Vytvoření indexu dokumentů .NET s Aspose.GroupDocs Redaction

Správa velkých kolekcí souborů může rychle přerůst v noční můru, pokud nemáte spolehlivý způsob, jak udržet složky přehledné a svůj vyhledávací index aktuální. V tomto tutoriálu se naučíte, jak vytvořit index dokumentů .net pomocí GroupDocs.Redaction pro .NET, zahrnující přípravu adresáře, vytvoření indexu, přejmenování dokumentů a aktualizace indexu. Na konci budete mít opakovatelný workflow, který škáluje od několika PDF po tisíce právních nebo podporných dokumentů.

Rychlé odpovědi

  • Jaká knihovna potřebuji? GroupDocs.Redaction for .NET (latest NuGet version).
  • Které verze .NET jsou podporovány? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6+.
  • Kolik formátů lze indexovat? Více než 50 vstupních formátů — včetně PDF, DOCX, XLSX, PPTX a běžných typů obrázků.
  • Mohu přejmenovat soubory bez poškození indexu? Ano—použijte vestavěnou metodu Rename a poté zavolejte NotifyIndex.
  • Je licence vyžadována pro produkci? Platná licence GroupDocs.Redaction je povinná pro produkční použití.

Co je „Create Document Index .NET“?

Create document index .net odkazuje na proces vytváření prohledávatelného katalogu souborů v .NET aplikaci, kde každá položka ukládá metadata jako název souboru, cestu a úryvky obsahu. Tento index umožňuje rychlé vyhledávání bez nutnosti skenovat celý souborový systém při každém dotazu.

Proč použít GroupDocs.Redaction pro indexování?

GroupDocs.Redaction nejenže rediguje citlivý obsah, ale také poskytuje vysoce výkonný indexovací engine, který dokáže zpracovat až 10 000 dokumentů za minutu na standardním 8‑jádrovém serveru, přičemž spotřeba paměti zůstává pod 200 MB pro většinu pracovních zátěží. Jeho API abstrahuje nesrovnalosti souborového systému a poskytuje konzistentní způsob správy adresářů a synchronizace indexů.

Předpoklady

  • GroupDocs.Redaction NuGet balíček nainstalován (nejnovější stabilní verze).
  • Visual Studio 2022 nebo jakékoli .NET‑kompatibilní IDE.
  • Základní znalost C# (souborové I/O, zpracování výjimek).

Požadované knihovny, verze a závislosti

  • GroupDocs.Redaction ≥ 23.10 (podporuje .NET Standard 2.0 a .NET 5+).
  • Volitelné: Microsoft.Extensions.Logging pro podrobnou diagnostiku.

Požadavky na nastavení prostředí

Přidejte balíček pomocí jednoho z následujících příkazů ( ne upravujte zástupce, které představují skutečné bloky kódu):

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI
Vyhledejte „GroupDocs.Redaction“ a nainstalujte nejnovější verzi.

Kroky získání licence

  1. Free Trial – Získejte 30‑denní zkušební verzi z portálu GroupDocs.
  2. Temporary License – Požádejte o dočasný klíč pro rozšířené testování.
  3. Purchase – Získejte produkční licenci pro odemknutí plné funkčnosti.

Jak připravit čistý pracovní adresář?

Načtěte cílovou složku, odstraňte zbylé dočasné soubory a zkopírujte zdrojové dokumenty, které chcete indexovat. Tento krok přípravy eliminuje chyby „soubor‑v‑použití“ během indexování a zajišťuje, že tvůrce indexu pracuje s deterministickou sadou souborů. Zajištěním čistého prostředí snižujete falešně‑kladné výsledky, vyhnete se problémům s oprávněními a zlepšujete celkový výkon indexování.

Vyčistit adresář

Třída DirectoryCleaner odstraňuje zbylé soubory (např. *.tmp, *.bak), které by mohly rušit indexování.

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

string documentFolder = "YOUR_DOCUMENT_DIRECTORY/";

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

Zkopírovat potřebné soubory

FilePreparer kopíruje zdrojové PDF, DOCX a obrázky do pracovního adresáře, přičemž zachovává původní hierarchii složek.

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

Jak vytvořit index?

Index představuje prohledávatelnou kolekci dokumentů a spravuje podkladové úložné struktury.

Vytvořte instanci objektu Index, nasměrujte ji na váš čistý adresář a zavolejte Build. Tato operace prohledá každý soubor, extrahuje prohledávatelný text a uloží jej do efektivní binární struktury. Tvůrce také zaznamenává metadata jako cesty souborů a časové razítka, což umožňuje rychlé vyhledávání a inkrementální aktualizace bez opětovného zpracování nezměněných dokumentů.

Vytvořit index

Třída Index je hlavní komponentou, která představuje prohledávatelnou kolekci dokumentů.

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/");

Jak přejmenovat dokumenty a upozornit index?

DocumentRenamer poskytuje nástroje pro přejmenování souborů při zachování integrity indexu.

DocumentRenamer.RenameAndNotify přejmenuje soubor na disku a poté zavolá Index.UpdateEntry, aby katalog zůstal přesný. Provedením přejmenování a okamžitého upozornění indexu v jedné transakci se vyhnete zastaralým odkazům a zajistíte, že následná vyhledávání vrátí nový název souboru. Tato metoda také zaznamenává operaci pro auditní záznamy.

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

Jak aktualizovat existující index po změnách?

Index.Refresh aplikuje inkrementální změny na existující index bez úplného přestavování.

Index.Refresh zpracovává pouze delta (nové nebo změněné soubory), čímž snižuje zatížení CPU až o 85 % ve srovnání s kompletním přestavěním. Metoda skenuje pracovní adresář, identifikuje soubory s upravenými časovými razítky a aktualizuje jejich položky při zachování nedotčených dokumentů. Tento přístup výrazně zkracuje údržbová okna a udržuje vyhledávací zkušenost responzivní.

using GroupDocs.Search;

Index indexToUpdate = new Index(indexFolder);

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

Běžné případy použití

  1. Legal Document Management – Indexujte smlouvy, podání a soudní spisy pro okamžité vyhledání.
  2. Digital Library Systems – Poskytněte vyhledávání v reálném čase napříč tisíci e‑knihami a výzkumnými pracemi.
  3. Enterprise Content Management – Udržujte audit‑připravené adresáře, které automaticky odrážejí pojmenovací konvence.
  4. Customer Support Archives – Rychle najděte předchozí tickety, PDF a články znalostní báze.

Úvahy o výkonu

  • Batch Updates – Seskupte změny do dávek ≤ 500 souborů, aby se předešlo nadměrným I/O špičkám.
  • Memory Management – Uvolněte objekt Index po každé operaci; knihovna automaticky uvolní nativní buffery.
  • Parallel Scanning – Povolením IndexOptions.EnableParallelProcessing využijete vícejádrové CPU a dosáhnete až 3× zrychlení na 8‑jádrovém stroji.

Často kladené otázky

Q: Jaký je hlavní účel GroupDocs.Redaction?
A: Rediguje citlivý obsah z PDF, DOCX a obrázků a zároveň nabízí robustní nástroje pro správu adresářů a indexování.

Q: Mohu spravovat více adresářů současně?
A: Ano—vytvořte samostatné instance Index pro každou složku a provozujte je paralelně.

Q: Jak zacházet s chybami během indexování?
A: Obalte Index.Build a Index.Refresh do try‑catch bloků; zaznamenejte podrobnosti RedactionException pro řešení problémů.

Q: Jaké jsou systémové požadavky pro GroupDocs.Redaction?
A: Runtime .NET Framework 4.6+ nebo .NET Core 3.1+, alespoň 2 GB RAM a 500 MB volného místa na disku pro dočasné buffery.

Q: Jak mohu optimalizovat výkon indexu pro velké sady dokumentů?
A: Pravidelně volajte Index.Refresh, povolte paralelní zpracování a omezte velikosti dávek, aby byl spotřeba paměti pod kontrolou.

Další zdroje

Poslední aktualizace: 2026-06-22
Testováno s: GroupDocs.Redaction 23.10 for .NET
Autor: GroupDocs

using GroupDocs.Redaction;

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

Související tutoriály