Créer un index de recherche .NET avec GroupDocs.Redaction : indexation et gestion des alias pour une gestion sécurisée des documents

Gérer de grands volumes de documents tout en maintenant la confidentialité des informations sensibles peut être difficile. Avec GroupDocs.Redaction for .NET vous pouvez create search index .NET projets qui masquent et recherchent dans vos collections de documents efficacement. Ce tutoriel vous guide à travers la création ou l’ouverture d’un index en utilisant Aspose.Search.NET, l’ajout de documents à l’index, la gestion des dictionnaires d’alias et l’intégration des capacités de masquage — tout en maintenant une sécurité stricte des données.

Réponses rapides

  • Quel est le but principal de ce guide ? Pour vous montrer comment create search index .NET projets, ajouter des documents à l’index et gérer les alias avec GroupDocs.Redaction.
  • Quelles bibliothèques sont requises ? GroupDocs.Redaction et Aspose.Search.NET, toutes deux disponibles via NuGet.
  • Ai-je besoin d’une licence ? Un essai gratuit fonctionne pour l’évaluation ; une licence complète est requise pour la production.
  • Puis-je gérer de grands ensembles de documents ? Oui — les deux bibliothèques prennent en charge le traitement de fichiers de plusieurs centaines de pages sans charger le fichier complet en mémoire.
  • La solution est‑elle compatible avec .NET‑Core ? Absolument ; elle fonctionne sur .NET 5, .NET 6 et les versions ultérieures.

Introduction

Avant de commencer, clarifions pourquoi creating a search index .NET solution est important. Un index vous permet de localiser des phrases exactes, des modèles ou du contenu masqué à travers des milliers de fichiers en millisecondes, accélérant considérablement les revues de conformité, la découverte juridique et les audits internes. En associant le puissant moteur d’indexation d’Aspose.Search.NET aux outils de masquage robustes de GroupDocs.Redaction, vous obtenez un pipeline unique qui protège et trouve les données instantanément.

Qu’est-ce que GroupDocs.Redaction pour .NET ?

GroupDocs.Redaction for .NET est une bibliothèque qui permet le masquage programmatique de texte, d’images et de métadonnées sur plus de 30 formats de documents, y compris PDF, DOCX, PPTX et HTML. Elle traite des fichiers jusqu’à 2 Go sans charger le document complet en RAM, garantissant des opérations haute performance sur des charges de travail d’entreprise.

Pourquoi créer un search index .NET avec Aspose.Search.NET ?

Aspose.Search.NET peut indexer 50+ types de fichiers et prend en charge les mises à jour incrémentielles, ce qui signifie que vous pouvez ajouter de nouveaux fichiers à un index existant sans le reconstruire à partir de zéro. Cela réduit l’utilisation du CPU jusqu’à 70 % par rapport à un ré‑indexage complet, et les temps de réponse des requêtes restent inférieurs à 200 ms pour des index contenant plus de 500 k documents.

Prérequis

Bibliothèques requises, versions et dépendances

  • GroupDocs.Redaction – dernière version NuGet, compatible avec .NET 5/6/7.
  • Aspose.Search.NET – dernière version NuGet, prend en charge .NET Standard 2.0+ et .NET Core.

Les deux bibliothèques doivent cibler la même version du runtime .NET afin d’éviter les conflits de liaison.

Exigences de configuration de l’environnement

  • Visual Studio 2022 (ou tout IDE supportant .NET 6+).
  • Accès à un dossier contenant les documents que vous souhaitez indexer et masquer.

Prérequis de connaissances

  • Familiarité avec la syntaxe C# et les structures de projets .NET.
  • Concepts de base de l’indexation, de la recherche et du masquage de documents.

Comment créer un search index .NET ?

Chargez ou instanciez un objet Index, pointez-le vers un dossier et appelez CreateOrOpen — cette étape unique crée ou rouvre le magasin de recherche sur le disque. L’opération s’exécute par défaut dans un thread d’arrière-plan, de sorte que votre interface reste réactive même lors de l’indexation de milliers de fichiers.

Index représente la collection recherchable stockée sur le disque.

Ancre de définition

La classe Index est le composant central d’Aspose.Search.NET qui représente une collection recherchable de documents sur le disque. Toutes les opérations d’indexation et de requête passent par cet objet.

dotnet add package GroupDocs.Redaction

Comment ajouter des documents à l’index ?

AddDocument ajoute un fichier à l’index et extrait son contenu recherchable.

Ajoutez des documents en appelant Index.AddDocument pour chaque chemin de fichier ; la méthode extrait automatiquement le texte, les métadonnées et le contenu OCR optionnel. Vous pouvez ajouter des fichiers par lots dans une boucle foreach, et l’index sera mis à jour de façon incrémentielle sans reconstruire les entrées existantes. Le processus renvoie également un objet d’état indiquant le succès ou les éventuelles erreurs, vous permettant de gérer les échecs de manière programmatique.

Install-Package GroupDocs.Redaction

Étapes d’acquisition de licence

  • Essai gratuit – Explorez toutes les fonctionnalités sans frais pendant 30 jours.
  • Licence temporaire – Utilisez une clé à durée limitée pour des tests prolongés.
  • Licence complète – Requise pour les déploiements en production et supprime toutes les limitations d’évaluation.

Une fois installé, initialisez GroupDocs.Redaction comme indiqué ci‑dessous :

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

Guide d’implémentation

Nous allons décomposer l’implémentation en sections gérables basées sur les fonctionnalités.

Création ou ouverture d’un index

Vue d’ensemble

Créer ou ouvrir un index de recherche est fondamental pour une gestion et une recherche de documents efficaces. Cela vous permet de travailler rapidement avec des données indexées.

Instructions étape par étape

1. Créer/Ouvrir l’index

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. Ajouter des documents à l’index

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.

Gestion du dictionnaire d’alias

Vue d’ensemble

Les alias dans un dictionnaire d’alias vous permettent de définir des termes raccourcis pour des requêtes de recherche complexes, améliorant l’efficacité et la lisibilité de la recherche.

Instructions étape par étape

1. Effacer les alias existants

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. Ajouter des entrées d’alias uniques

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. Ajouter plusieurs alias à l’aide d’un tableau

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.

Récupération et exportation des alias

Vue d’ensemble

Exporter votre dictionnaire d’alias vers un fichier vous permet de partager les vocabulaires de recherche entre équipes ou environnements, tandis que la récupération d’entrées spécifiques vous aide à valider la logique des requêtes.

Récupérer l’alias

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

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

Exporter les alias

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

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

Importation des alias et recherche avec le dictionnaire d’alias

Vue d’ensemble

Importez des alias depuis un fichier pour rationaliser les opérations de recherche en utilisant des termes raccourcis prédéfinis, puis exécutez des requêtes qui font référence à ces alias.

1. Importer les alias

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

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

2. Rechercher en utilisant des alias

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.

Problèmes courants et solutions

  • Erreurs de chemin d’index – Assurez-vous que le chemin du dossier est absolu et que l’application dispose des autorisations de lecture/écriture.
  • Fuites de mémoire – Appelez toujours Dispose() sur les objets Index après utilisation, surtout dans les services à long terme.
  • Alias non reconnu – Vérifiez que le fichier d’alias utilise l’encodage UTF‑8 et que chaque ligne suit le format key=value.

Questions fréquemment posées

Q : Puis‑je utiliser cette solution avec .NET Core ?
R : Oui, GroupDocs.Redaction et Aspose.Search.NET prennent pleinement en charge .NET Core 3.1, .NET 5, .NET 6 et les versions ultérieures.

Q : Combien de documents l’index peut‑il gérer ?
R : Le moteur a été testé avec des index contenant plus d'1 million de documents, maintenant des temps de requête inférieurs à une seconde sur du matériel serveur standard.

Q : Les alias prennent‑ils en charge les expressions régulières ?
R : Les alias peuvent contenir des caractères génériques (* et ?) mais pas de motifs regex complets ; pour des motifs complexes, construisez la requête programmatique.

Q : Est‑il possible de masquer après la recherche ?
R : Absolument. Récupérez l’ID du document depuis le résultat de recherche, chargez‑le avec GroupDocs.Redaction, appliquez les règles de masquage et enregistrez la version protégée.

Q : Quel modèle de licence s’applique aux grandes entreprises ?
R : GroupDocs propose une licence basée sur le volume avec développeurs et sites de déploiement illimités ; contactez les ventes pour un devis personnalisé.

Conclusion

En maîtrisant l’intégration de GroupDocs.Redaction avec Aspose.Search.NET pour create search index .NET solutions, vous pouvez améliorer considérablement la sécurité des documents, la conformité et la découvrabilité. Vous disposez désormais des outils pour créer un index, ajouter des documents à l’index, gérer les dictionnaires d’alias et appliquer des règles de masquage — le tout dans une seule application .NET haute performance.

Prochaines étapes ? Implémentez les extraits de code dans un projet de test, expérimentez des modèles d’alias personnalisés et mesurez la vitesse d’indexation par rapport à votre jeu de données de production.

Dernière mise à jour : 2026-07-02
Testé avec : GroupDocs.Redaction 23.10 pour .NET, Aspose.Search.NET 24.5
Auteur : GroupDocs

Tutoriels associés