Utwórz indeks dokumentów .NET z Aspose.GroupDocs Redaction

Zarządzanie dużymi zbiorami plików może szybko stać się koszmarem, jeśli nie masz niezawodnego sposobu na utrzymanie porządku w folderach i aktualności indeksu wyszukiwania. W tym samouczku nauczysz się, jak utworzyć indeks dokumentów .net przy użyciu GroupDocs.Redaction dla .NET, obejmując przygotowanie katalogu, tworzenie indeksu, zmianę nazw dokumentów i aktualizacje indeksu. Po zakończeniu będziesz mieć powtarzalny przepływ pracy, który skaluje się od kilku plików PDF do tysięcy dokumentów prawnych lub wsparcia.

Szybkie odpowiedzi

  • Jakiej biblioteki potrzebuję? GroupDocs.Redaction for .NET (latest NuGet version).
  • Które wersje .NET są obsługiwane? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6+.
  • Ile formatów można indeksować? Ponad 50 formatów wejściowych — w tym PDF, DOCX, XLSX, PPTX oraz popularne typy obrazów.
  • Czy mogę zmienić nazwę plików bez uszkadzania indeksu? Tak—użyj wbudowanej metody Rename, a następnie wywołaj NotifyIndex.
  • Czy wymagana jest licencja do produkcji? Ważna licencja GroupDocs.Redaction jest obowiązkowa w środowisku produkcyjnym.

Co to jest „Utwórz indeks dokumentów .NET”?

Create document index .net odnosi się do procesu budowania przeszukiwalnego katalogu plików w aplikacji .NET, gdzie każdy wpis przechowuje metadane takie jak nazwa pliku, ścieżka i fragmenty treści. Ten indeks umożliwia szybkie wyszukiwania bez skanowania całego systemu plików za każdym razem.

Dlaczego używać GroupDocs.Redaction do indeksowania?

GroupDocs.Redaction nie tylko redaguje wrażliwe treści, ale także zapewnia wydajny silnik indeksujący, który może obsłużyć do 10 000 dokumentów na minutę na standardowym serwerze 8‑rdzeniowym, przy jednoczesnym utrzymaniu zużycia pamięci poniżej 200 MB w większości obciążeń. Jego API ukrywa niuanse systemu plików, dając spójny sposób zarządzania katalogami i synchronizacji indeksów.

Wymagania wstępne

  • GroupDocs.Redaction pakiet NuGet zainstalowany (najnowsze stabilne wydanie).
  • Visual Studio 2022 lub dowolne IDE kompatybilne z .NET.
  • Podstawowa znajomość C# (operacje na plikach, obsługa wyjątków).

Wymagane biblioteki, wersje i zależności

  • GroupDocs.Redaction ≥ 23.10 (obsługuje .NET Standard 2.0 i .NET 5+).
  • Opcjonalnie: Microsoft.Extensions.Logging do szczegółowej diagnostyki.

Wymagania dotyczące konfiguracji środowiska

Dodaj pakiet za pomocą jednej z poniższych komend (nie modyfikuj placeholderów reprezentujących rzeczywiste bloki kodu):

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI
Wyszukaj „GroupDocs.Redaction” i zainstaluj najnowszą wersję.

Kroki uzyskania licencji

  1. Free Trial – Uzyskaj 30‑dniowy okres próbny z portalu GroupDocs.
  2. Temporary License – Poproś o tymczasowy klucz do rozszerzonego testowania.
  3. Purchase – Uzyskaj licencję produkcyjną, aby odblokować pełną funkcjonalność.

Jak przygotować czysty katalog roboczy?

Wczytaj docelowy folder, usuń niepotrzebne pliki tymczasowe i skopiuj dokumenty źródłowe, które zamierzasz indeksować. Ten krok przygotowawczy eliminuje błędy „plik‑w‑użyciu” podczas indeksowania i zapewnia, że budowniczy indeksu działa na deterministycznym zestawie plików. Zapewniając nieskazitelne środowisko, zmniejszasz liczbę fałszywych alarmów, unikasz problemów z uprawnieniami i poprawiasz ogólną wydajność indeksowania.

Wyczyść katalog

Klasa DirectoryCleaner usuwa pozostałe pliki (np. *.tmp, *.bak), które mogą zakłócać indeksowanie.

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

string documentFolder = "YOUR_DOCUMENT_DIRECTORY/";

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

Skopiuj niezbędne pliki

FilePreparer kopiuje źródłowe pliki PDF, DOCX i obrazy do folderu roboczego, zachowując pierwotną strukturę katalogów.

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

Jak utworzyć indeks?

Index reprezentuje przeszukiwalną kolekcję dokumentów i zarządza podstawowymi strukturami przechowywania.

Utwórz obiekt Index, wskaż go na swój czysty katalog i wywołaj Build. Ta operacja skanuje każdy plik, wyodrębnia tekst możliwy do przeszukania i zapisuje go w wydajnej strukturze binarnej. Budowniczy zapisuje także metadane, takie jak ścieżki plików i znaczniki czasu, umożliwiając szybkie wyszukiwania i przyrostowe aktualizacje bez ponownego przetwarzania niezmienionych dokumentów.

Utwórz indeks

Klasa Index jest podstawowym komponentem reprezentującym przeszukiwalną kolekcję dokumentów.

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 zmienić nazwę dokumentów i powiadomić indeks?

DocumentRenamer zapewnia narzędzia do zmiany nazw plików przy zachowaniu integralności indeksu.

DocumentRenamer.RenameAndNotify zmienia nazwę pliku na dysku, a następnie wywołuje Index.UpdateEntry, aby katalog był aktualny. Przeprowadzając zmianę nazwy i natychmiastowe powiadomienie indeksu w jednej transakcji, unikasz przestarzałych odwołań i zapewniasz, że kolejne wyszukiwania zwracają nową nazwę pliku. Metoda ta również loguje operację w celach audytu.

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 zaktualizować istniejący indeks po zmianach?

Index.Refresh stosuje przyrostowe zmiany do istniejącego indeksu bez pełnego przebudowywania.

Index.Refresh przetwarza tylko delta (nowe lub zmienione pliki), zmniejszając obciążenie CPU o do 85 % w porównaniu z pełnym przebudowaniem. Metoda skanuje katalog roboczy, identyfikuje pliki ze zmodyfikowanymi znacznikami czasu i aktualizuje ich wpisy, zachowując niezmienione dokumenty. Takie podejście znacznie skraca okna konserwacji i utrzymuje responsywność wyszukiwania.

using GroupDocs.Search;

Index indexToUpdate = new Index(indexFolder);

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

Typowe przypadki użycia

  1. Zarządzanie dokumentami prawnymi – Indeksuj umowy, pisma i akta spraw, aby uzyskać natychmiastowy dostęp.
  2. Systemy bibliotek cyfrowych – Zapewnij wyszukiwanie w czasie rzeczywistym wśród tysięcy e‑booków i prac naukowych.
  3. Enterprise Content Management – Utrzymuj katalogi gotowe do audytu, które automatycznie odzwierciedlają konwencje nazewnictwa.
  4. Archiwa wsparcia klienta – Szybko znajdź wcześniejsze zgłoszenia, PDF‑y i artykuły bazy wiedzy.

Rozważania dotyczące wydajności

  • Batch Updates – Grupuj zmiany w partie ≤ 500 plików, aby uniknąć nadmiernych skoków I/O.
  • Memory Management – Zwolnij obiekt Index po każdej operacji; biblioteka automatycznie zwalnia natywne bufory.
  • Parallel Scanning – Włącz IndexOptions.EnableParallelProcessing, aby wykorzystać wielordzeniowe CPU, osiągając do 3× przyspieszenia na maszynie 8‑rdzeniowej.

Najczęściej zadawane pytania

Q: Jaki jest główny cel użycia GroupDocs.Redaction?
A: Redaguje wrażliwe treści w PDF‑ach, DOCX‑ach i obrazach, a także oferuje solidne narzędzia do zarządzania katalogami i indeksowania.

Q: Czy mogę zarządzać wieloma katalogami jednocześnie?
A: Tak—utwórz osobne instancje Index dla każdego folderu i obsługuj je równolegle.

Q: Jak obsługiwać błędy podczas indeksowania?
A: Otocz Index.Build i Index.Refresh blokami try‑catch; loguj szczegóły RedactionException w celu rozwiązywania problemów.

Q: Jakie są wymagania systemowe dla GroupDocs.Redaction?
A: Środowisko uruchomieniowe .NET Framework 4.6+ lub .NET Core 3.1+, co najmniej 2 GB RAM oraz 500 MB wolnego miejsca na dysku na tymczasowe bufory.

Q: Jak mogę zoptymalizować wydajność indeksu przy dużych zestawach dokumentów?
A: Regularnie wywołuj Index.Refresh, włącz przetwarzanie równoległe i ograniczaj rozmiary partii, aby utrzymać zużycie pamięci pod kontrolą.

Dodatkowe zasoby

Ostatnia aktualizacja: 2026-06-22
Testowano z: 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");

Powiązane samouczki