Utwórz indeks wyszukiwania .NET z GroupDocs.Redaction: indeksowanie i zarządzanie aliasami dla bezpiecznego zarządzania dokumentami

Zarządzanie dużymi wolumenami dokumentów przy jednoczesnym zachowaniu poufności wrażliwych informacji może być wyzwaniem. Dzięki GroupDocs.Redaction for .NET możesz create search index .NET projekty, które redagują i przeszukują Twoje kolekcje dokumentów efektywnie. Ten samouczek przeprowadzi Cię przez tworzenie lub otwieranie indeksu przy użyciu Aspose.Search.NET, dodawanie dokumentów do indeksu, zarządzanie słownikami aliasów oraz integrację funkcji redakcji — wszystko przy zachowaniu ścisłej ochrony danych.

Szybkie odpowiedzi

  • Jaki jest główny cel tego przewodnika? Aby pokazać, jak create search index .NET projekty, dodać dokumenty do indeksu i zarządzać aliasami przy użyciu GroupDocs.Redaction.
  • Jakie biblioteki są wymagane? GroupDocs.Redaction i Aspose.Search.NET, oba dostępne przez NuGet.
  • Czy potrzebna jest licencja? Darmowa wersja próbna działa w ocenie; pełna licencja jest wymagana w produkcji.
  • Czy mogę obsługiwać duże zestawy dokumentów? Tak — obie biblioteki obsługują przetwarzanie plików wielostronicowych bez ładowania całego pliku do pamięci.
  • Czy rozwiązanie jest kompatybilne z .NET‑Core? Absolutnie; działa na .NET 5, .NET 6 i nowszych wersjach.

Wprowadzenie

Zanim zaczniemy, wyjaśnijmy, dlaczego creating a search index .NET rozwiązanie ma znaczenie. Indeks pozwala znaleźć dokładne frazy, wzorce lub zredagowaną treść w tysiącach plików w milisekundach, dramatycznie przyspieszając przeglądy zgodności, odkrywanie prawne i audyty wewnętrzne. Łącząc potężny silnik indeksowania Aspose.Search.NET z solidnymi narzędziami redakcji GroupDocs.Redaction, uzyskasz jedną linię przetwarzania, która jednocześnie chroni i natychmiast znajduje dane.

Co to jest GroupDocs.Redaction for .NET?

GroupDocs.Redaction for .NET to biblioteka umożliwiająca programistyczną redakcję tekstu, obrazów i metadanych w ponad 30 formatach dokumentów, w tym PDF, DOCX, PPTX i HTML. Przetwarza pliki do 2 GB bez ładowania całego dokumentu do pamięci RAM, zapewniając wysoką wydajność operacji w środowiskach korporacyjnych.

Dlaczego tworzyć indeks wyszukiwania .NET z Aspose.Search.NET?

Aspose.Search.NET może indeksować ponad 50 typów plików i obsługuje aktualizacje przyrostowe, co oznacza, że możesz dodawać nowe pliki do istniejącego indeksu bez konieczności przebudowy od podstaw. To zmniejsza zużycie CPU nawet o 70 % w porównaniu z pełnym ponownym indeksowaniem, a czasy odpowiedzi zapytań pozostają poniżej 200 ms dla indeksów zawierających ponad 500 k dokumentów.

Wymagania wstępne

Wymagane biblioteki, wersje i zależności

  • GroupDocs.Redaction – najnowsze wydanie NuGet, kompatybilne z .NET 5/6/7.
  • Aspose.Search.NET – najnowsze wydanie NuGet, obsługuje .NET Standard 2.0+ i .NET Core.

Obie biblioteki muszą celować w tę samą wersję środowiska uruchomieniowego .NET, aby uniknąć konfliktów wiązania.

Wymagania dotyczące konfiguracji środowiska

  • Visual Studio 2022 (lub dowolne IDE obsługujące .NET 6+).
  • Dostęp do folderu zawierającego dokumenty, które chcesz indeksować i redagować.

Wymagania wiedzy

  • Znajomość składni C# i struktury projektów .NET.
  • Podstawowe pojęcia dotyczące indeksowania, wyszukiwania i redakcji dokumentów.

Jak utworzyć indeks wyszukiwania .NET?

Załaduj lub zainicjuj obiekt Index, wskaż folder i wywołaj CreateOrOpen — ten pojedynczy krok buduje lub ponownie otwiera przeszukiwalny magazyn na dysku. Operacja domyślnie działa w tle, więc interfejs użytkownika pozostaje responsywny nawet przy indeksowaniu tysięcy plików.

Index reprezentuje przeszukiwalną kolekcję przechowywaną na dysku.

Definicja kotwicy

Klasa Index jest podstawowym komponentem Aspose.Search.NET, który reprezentuje przeszukiwalną kolekcję dokumentów na dysku. Wszystkie operacje indeksowania i zapytań przepływają przez ten obiekt.

dotnet add package GroupDocs.Redaction

Jak dodać dokumenty do indeksu?

AddDocument dodaje plik do indeksu i wyodrębnia jego przeszukiwalną zawartość.

Dodawaj dokumenty, wywołując Index.AddDocument dla każdej ścieżki pliku; metoda automatycznie wyodrębnia tekst, metadane i opcjonalną treść OCR. Możesz dodawać pliki partiami w pętli foreach, a indeks będzie aktualizowany przyrostowo bez przebudowy istniejących wpisów. Proces zwraca również obiekt statusu wskazujący sukces lub ewentualne błędy, co umożliwia programowe obsłużenie niepowodzeń.

Install-Package GroupDocs.Redaction

Kroki uzyskania licencji

  • Free Trial – Przeglądaj wszystkie funkcje bez kosztów przez 30 dni.
  • Temporary License – Użyj klucza czasowo ograniczonego do rozszerzonego testowania.
  • Full License – Wymagana przy wdrożeniach produkcyjnych i usuwa wszystkie ograniczenia wersji próbnej.

Po zainstalowaniu, zainicjalizuj GroupDocs.Redaction jak pokazano poniżej:

using GroupDocs.Redaction;
RedactorSettings settings = new RedactorSettings();
// Set up additional configuration as needed

Przewodnik implementacji

Podzielimy implementację na przystępne sekcje w oparciu o funkcje.

Tworzenie lub otwieranie indeksu

Przegląd

Tworzenie lub otwieranie indeksu wyszukiwania jest podstawą efektywnego zarządzania dokumentami i wyszukiwania. Umożliwia szybkie pracowanie z danymi indeksowanymi.

Instrukcje krok po kroku

1. Utwórz/Otwórz indeks

using GroupDocs.Search;

// Specify the directory where your index will be stored
string indexPath = "YOUR_INDEX_DIRECTORY";

// Initialize or open an existing index
Index index = new Index(indexPath);

// Explanation: The Index object is initialized with a directory path,
// which serves as a storage location for all indexed data.

2. Dodaj dokumenty do indeksu

using GroupDocs.Search;

// Specify your document directory
string docPath = "YOUR_DOCUMENT_DIRECTORY";

// Add documents from the specified directory to the index
index.Add(docPath);

// Explanation: The Add method indexes all documents within the provided path,
// making them searchable.

Zarządzanie słownikiem aliasów

Przegląd

Aliasy w słowniku aliasów pozwalają definiować skrócone terminy dla złożonych zapytań wyszukiwania, zwiększając efektywność i czytelność wyszukiwania.

Instrukcje krok po kroku

1. Wyczyść istniejące aliasy

using GroupDocs.Search.Dictionaries;

// Check if there are existing aliases and clear them
if (index.Dictionaries.AliasDictionary.Count > 0)
{
    index.Dictionaries.AliasDictionary.Clear();
}

// Explanation: This ensures you start with a clean slate when managing aliases.

2. Dodaj pojedyncze wpisy aliasów

index.Dictionaries.AliasDictionary.Add("t", "(gravida OR promotion)");
index.Dictionaries.AliasDictionary.Add("e", "(viverra OR farther)");

// Explanation: Each alias is mapped to an expression that defines its search scope.

3. Dodaj wiele aliasów przy użyciu tablicy

AliasReplacementPair[] pairs = new AliasReplacementPair[]
{
    new AliasReplacementPair("d", "daterange(2017-01-01 ~~ 2019-12-31)"),
    new AliasReplacementPair("n", "(400 ~~ 4000)")
};

index.Dictionaries.AliasDictionary.AddRange(pairs);

// Explanation: AddRange allows bulk addition of aliases, streamlining the setup process.

Pobieranie i eksportowanie aliasów

Przegląd

Eksportowanie słownika aliasów do pliku umożliwia udostępnianie słownictwa wyszukiwania zespołom lub środowiskom, a pobieranie konkretnych wpisów pomaga w weryfikacji logiki zapytań.

Pobierz alias

if (index.Dictionaries.AliasDictionary.Contains("e"))
{
    string replacement = index.Dictionaries.AliasDictionary.GetText("e");
}

// Explanation: Use Contains to check existence before retrieval.

Eksportuj aliasy

string exportPath = "YOUR_OUTPUT_DIRECTORY/Aliases.dat";
index.Dictionaries.AliasDictionary.ExportDictionary(exportPath);

// Explanation: ExportDictionary saves the alias dictionary for future use or sharing.

Importowanie aliasów i wyszukiwanie przy użyciu słownika aliasów

Przegląd

Importuj aliasy z pliku, aby usprawnić operacje wyszukiwania przy użyciu zdefiniowanych wcześniej skrótów, a następnie wykonuj zapytania odwołujące się do tych aliasów.

1. Importuj aliasy

string importPath = "YOUR_OUTPUT_DIRECTORY/Aliases.dat";
index.Dictionaries.AliasDictionary.ImportDictionary(importPath);

// Explanation: This method loads existing alias definitions into the dictionary.

2. Wyszukaj przy użyciu aliasów

string query = "@t OR @e"; // Use aliases in your search query
SearchResult result = index.Search(query);

// Explanation: Leverage aliases to perform complex searches with simple queries.

Typowe problemy i rozwiązania

  • Błędy ścieżki indeksu – Upewnij się, że ścieżka folderu jest bezwzględna i aplikacja ma uprawnienia odczytu/zapisu.
  • Wycieki pamięci – Zawsze wywołuj Dispose() na obiektach Index po użyciu, szczególnie w długotrwale działających usługach.
  • Alias nie rozpoznany – Sprawdź, czy plik aliasów używa kodowania UTF‑8 i czy każda linia ma format key=value.

Najczęściej zadawane pytania

Q: Czy mogę używać tego rozwiązania z .NET Core?
A: Tak, zarówno GroupDocs.Redaction, jak i Aspose.Search.NET w pełni obsługują .NET Core 3.1, .NET 5, .NET 6 i nowsze.

Q: Ile dokumentów może obsłużyć indeks?
A: Silnik został przetestowany na indeksach zawierających ponad 1 milion dokumentów, utrzymując czasy zapytań poniżej sekundy na standardowym sprzęcie serwerowym.

Q: Czy aliasy obsługują wyrażenia regularne?
A: Alias może zawierać znaki wieloznaczne (* i ?), ale nie pełne wzorce regex; w przypadku złożonych wzorców buduj zapytanie programowo.

Q: Czy możliwe jest redagowanie po wyszukaniu?
A: Absolutnie. Pobierz identyfikator dokumentu z wyniku wyszukiwania, załaduj go przy użyciu GroupDocs.Redaction, zastosuj reguły redakcji i zapisz wersję chronioną.

Q: Jaki model licencjonowania obowiązuje w dużych przedsiębiorstwach?
A: GroupDocs oferuje licencjonowanie oparte na wolumenie z nieograniczoną liczbą programistów i miejsc wdrożenia; skontaktuj się z działem sprzedaży po indywidualną wycenę.

Zakończenie

Opanowując integrację GroupDocs.Redaction z Aspose.Search.NET w celu create search index .NET rozwiązań, możesz znacząco poprawić bezpieczeństwo dokumentów, zgodność i możliwość ich odnalezienia. Masz teraz narzędzia do budowania indeksu, dodawania dokumentów do indeksu, zarządzania słownikami aliasów i stosowania reguł redakcji — wszystko w jednej, wysokowydajnej aplikacji .NET.

Kolejne kroki? Zaimplementuj fragmenty kodu w projekcie testowym, eksperymentuj z własnymi wzorcami aliasów i zmierz prędkość indeksowania w stosunku do zestawu danych produkcyjnych.

Last Updated: 2026-07-02
Tested With: GroupDocs.Redaction 23.10 for .NET, Aspose.Search.NET 24.5
Author: GroupDocs

Powiązane samouczki