Создание поискового индекса .NET с GroupDocs.Redaction: Индексирование и управление псевдонимами для безопасного управления документами

Управление большими объёмами документов при сохранении конфиденциальности чувствительной информации может быть сложной задачей. С помощью GroupDocs.Redaction for .NET вы можете create search index .NET проекты, которые редактируют и ищут по вашим коллекциям документов эффективно. Этот учебник проведёт вас через создание или открытие индекса с использованием Aspose.Search.NET, добавление документов в индекс, управление словарями псевдонимов и интеграцию возможностей редактирования — всё это при строгом соблюдении безопасности данных.

Быстрые ответы

  • Какова основная цель данного руководства? Показать, как create search index .NET проекты, добавлять документы в индекс и управлять псевдонимами с помощью GroupDocs.Redaction.
  • Какие библиотеки требуются? GroupDocs.Redaction и Aspose.Search.NET, обе доступны через NuGet.
  • Нужна ли лицензия? Бесплатная пробная версия подходит для оценки; полная лицензия требуется для продакшн.
  • Могу ли я работать с большими наборами документов? Да — обе библиотеки поддерживают обработку файлов из нескольких сотен страниц без загрузки всего файла в память.
  • Совместимо ли решение с .NET‑Core? Абсолютно; оно работает на .NET 5, .NET 6 и более поздних версиях.

Введение

Прежде чем приступить, давайте разъясним, почему creating a search index .NET решение имеет значение. Индекс позволяет находить точные фразы, шаблоны или отредактированный контент в тысячах файлов за миллисекунды, значительно ускоряя проверки соответствия, юридическое обнаружение и внутренние аудиты. Объединив мощный движок индексирования Aspose.Search.NET с надёжными инструментами редактирования GroupDocs.Redaction, вы получаете единый конвейер, который одновременно защищает и мгновенно находит данные.

Что такое GroupDocs.Redaction для .NET?

GroupDocs.Redaction for .NET — это библиотека, позволяющая программно редактировать текст, изображения и метаданные более чем в 30 форматах документов, включая PDF, DOCX, PPTX и HTML. Она обрабатывает файлы до 2 ГБ без загрузки всего документа в ОЗУ, обеспечивая высокопроизводительные операции в корпоративных нагрузках.

Почему создавать поисковый индекс .NET с Aspose.Search.NET?

Aspose.Search.NET может индексировать 50+ типов файлов и поддерживает инкрементные обновления, что означает возможность добавлять новые файлы в существующий индекс без полной переиндексации. Это снижает нагрузку на процессор до 70 % по сравнению с полной переиндексацией, а время отклика запросов остаётся ниже 200 мс для индексов, содержащих более 500 тыс. документов.

Предварительные требования

Требуемые библиотеки, версии и зависимости

  • GroupDocs.Redaction – последняя версия в NuGet, совместима с .NET 5/6/7.
  • Aspose.Search.NET – последняя версия в NuGet, поддерживает .NET Standard 2.0+ и .NET Core.

Обе библиотеки должны использовать одну и ту же версию .NET runtime, чтобы избежать конфликтов привязок.

Требования к настройке среды

  • Visual Studio 2022 (или любой IDE, поддерживающий .NET 6+).
  • Доступ к папке, содержащей документы, которые вы хотите индексировать и редактировать.

Требования к знаниям

  • Знание синтаксиса C# и структуры .NET‑проектов.
  • Базовые понятия индексирования, поиска и редактирования документов.

Как создать поисковый индекс .NET?

Загрузите или создайте объект Index, укажите папку и вызовите CreateOrOpen — этот один шаг создаёт или открывает хранилище поиска на диске. Операция по умолчанию выполняется в фоновом потоке, поэтому ваш UI остаётся отзывчивым даже при индексации тысяч файлов.

Index представляет собой коллекцию, доступную для поиска, хранящуюся на диске.

Якорь определения

Класс Index — это основной компонент Aspose.Search.NET, представляющий собой коллекцию документов на диске, доступную для поиска. Все операции индексирования и запросов проходят через этот объект.

dotnet add package GroupDocs.Redaction

Как добавить документы в индекс?

AddDocument добавляет файл в индекс и извлекает его поисковый контент.

Добавляйте документы, вызывая Index.AddDocument для каждого пути к файлу; метод автоматически извлекает текст, метаданные и при необходимости контент OCR. Вы можете пакетно добавлять файлы в цикле foreach, и индекс будет обновляться инкрементно без перестройки существующих записей. Процесс также возвращает объект статуса, указывающий на успех или ошибки, позволяя программно обрабатывать сбои.

Install-Package GroupDocs.Redaction

Шаги получения лицензии

  • Free Trial – Исследуйте все функции бесплатно в течение 30 дней.
  • Temporary License – Используйте ограниченный по времени ключ для расширенного тестирования.
  • Full License – Требуется для продакшн‑развёртываний и устраняет все ограничения оценки.

После установки инициализируйте GroupDocs.Redaction, как показано ниже:

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

Руководство по реализации

Мы разобьём реализацию на управляемые разделы, основанные на функциях.

Создание или открытие индекса

Обзор

Создание или открытие поискового индекса является фундаментом для эффективного управления документами и поиска. Это позволяет быстро работать с индексированными данными.

Пошаговые инструкции

1. Создать/Открыть индекс

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. Добавить документы в индекс

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.

Управление словарем псевдонимов

Обзор

Псевдонимы в словаре псевдонимов позволяют определять короткие термины для сложных поисковых запросов, повышая эффективность и читаемость поиска.

Пошаговые инструкции

1. Очистить существующие псевдонимы

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. Добавить отдельные записи псевдонимов

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. Добавить несколько псевдонимов с помощью массива

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.

Получение и экспорт псевдонимов

Обзор

Экспорт вашего словаря псевдонимов в файл позволяет делиться словарями поиска между командами или средами, а получение конкретных записей помогает проверять логику запросов.

Получить псевдоним

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

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

Экспортировать псевдонимы

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

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

Импорт псевдонимов и поиск с использованием словаря псевдонимов

Обзор

Импортируйте псевдонимы из файла, чтобы упростить операции поиска с использованием предопределённых коротких терминов, затем выполните запросы, ссылающиеся на эти псевдонимы.

1. Импортировать псевдонимы

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

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

2. Поиск с использованием псевдонимов

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.

Распространённые проблемы и решения

  • Ошибки пути индекса – Убедитесь, что путь к папке абсолютный и приложение имеет права чтения/записи.
  • Утечки памяти – Всегда вызывайте Dispose() у объектов Index после использования, особенно в длительно работающих сервисах.
  • Псевдоним не распознан – Проверьте, что файл псевдонимов использует кодировку UTF‑8 и каждая строка соответствует формату key=value.

Часто задаваемые вопросы

Q: Могу ли я использовать это решение с .NET Core?
A: Да, как GroupDocs.Redaction, так и Aspose.Search.NET полностью поддерживают .NET Core 3.1, .NET 5, .NET 6 и более поздние версии.

Q: Сколько документов может обрабатывать индекс?
A: Движок протестирован на индексах, содержащих более 1 миллиона документов, обеспечивая время отклика менее секунды на стандартном серверном оборудовании.

Q: Поддерживают ли псевдонимы регулярные выражения?
A: Псевдонимы могут содержать символы подстановки (* и ?), но не полные регулярные выражения; для сложных шаблонов формируйте запрос программно.

Q: Можно ли выполнять редактирование после поиска?
A: Конечно. Получите ID документа из результата поиска, загрузите его с помощью GroupDocs.Redaction, примените правила редактирования и сохраните защищённую версию.

Q: Какая модель лицензирования применяется для крупных предприятий?
A: GroupDocs предлагает лицензирование на основе объёма с неограниченным количеством разработчиков и мест развертывания; свяжитесь с отделом продаж для получения индивидуального предложения.

Заключение

Освоив интеграцию GroupDocs.Redaction с Aspose.Search.NET для create search index .NET решений, вы можете значительно улучшить безопасность документов, соответствие требованиям и их обнаруживаемость. Теперь у вас есть инструменты для создания индекса, добавления документов в индекс, управления словарями псевдонимов и применения правил редактирования — всё в рамках одного высокопроизводительного .NET‑приложения.

Следующие шаги? Реализуйте фрагменты кода в тестовом проекте, поэкспериментируйте с пользовательскими шаблонами псевдонимов и измерьте скорость индексирования на ваших производственных данных.

Последнее обновление: 2026-07-02
Тестировано с: GroupDocs.Redaction 23.10 for .NET, Aspose.Search.NET 24.5
Автор: GroupDocs

Связанные руководства