Como Redigir Documentos com GroupDocs Search em .NET

Nas empresas modernas, como redigir documentos rapidamente e com segurança é um desafio diário. Usar o GroupDocs.Search junto com o GroupDocs.Redaction para .NET fornece uma solução robusta, pronta‑para‑uso que não apenas redige conteúdo sensível, mas também permite executar buscas difusas e destacar resultados de busca em HTML. Este tutorial orienta você na instalação das bibliotecas, criação de um índice, execução de uma consulta difusa e produção de saída destacada — tudo com trechos de código claros e prontos para produção.

Respostas Rápidas

  • Qual é o primeiro passo? Instale os pacotes NuGet GroupDocs.Search e GroupDocs.Redaction.
  • Posso redigir PDFs e arquivos Word? Sim, ambos os formatos são suportados prontamente.
  • A busca difusa está disponível? Absolutamente – você pode ajustar a precisão de 0 % a 100 %.
  • Preciso de licença para desenvolvimento? Uma licença de avaliação gratuita funciona para testes; uma licença paga é necessária para produção.
  • A solução funciona no .NET 6? Sim, as bibliotecas são compatíveis com .NET Framework 4.5+, .NET Core 3.1+, .NET 5+ e .NET 6+.

O que é o GroupDocs.Search?

GroupDocs.Search é uma biblioteca .NET que fornece indexação rápida e busca em texto completo em mais de 100 formatos de arquivo. Ela pode processar documentos de até 2 GB sem carregar o arquivo inteiro na memória, tornando‑a ideal para repositórios em grande escala. Suporta indexação incremental, análise multilíngue e integra‑se perfeitamente com aplicações .NET, permitindo que desenvolvedores criem experiências de busca poderosas com código mínimo.

Por que usar o GroupDocs.Redaction para redação de documentos?

GroupDocs.Redaction oferece mais de 30 padrões de redação incorporados e suporta processamento em lote, garantindo que dados pessoais, cláusulas confidenciais ou marcações regulatórias sejam removidos permanentemente. Em testes de benchmark, redigir um PDF de 500 páginas leva menos de 2 segundos em um servidor padrão. O mecanismo trabalha no fluxo de conteúdo do documento, assegurando que as áreas redigidas não possam ser recuperadas, e mantém a formatação e o layout originais.

Pré‑requisitos

  • Bibliotecas Necessárias: GroupDocs.Search, GroupDocs.Redaction
  • Plataformas Suportadas: .NET Framework 4.5+, .NET Core 3.1+, .NET 5+, .NET 6+
  • IDE: Visual Studio 2022 ou posterior (qualquer edição)
  • Habilidades Básicas: Familiaridade com C#, I/O de arquivos e conceitos de POO

Como configurar o GroupDocs.Search e o GroupDocs.Redaction em um projeto .NET?

Instale os pacotes NuGet via .NET CLI, Package Manager Console ou a interface gráfica, depois adicione um arquivo de licença ao seu projeto. Esta configuração em duas etapas é tudo que você precisa antes de escrever qualquer código de indexação ou redação. Após adicionar os pacotes, coloque o arquivo de licença na raiz da aplicação e referencie os namespaces nos seus arquivos de código.

Configurando o GroupDocs.Redaction para .NET

Para começar a usar o GroupDocs.Search e o GroupDocs.Redaction em suas aplicações .NET, siga estas etapas de instalação:

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager Console

Install-Package GroupDocs.Redaction

NuGet Package Manager UI
Pesquise por “GroupDocs.Redaction” e instale a versão mais recente.

Etapas de Aquisição de Licença

  1. Teste Gratuito: Inscreva‑se em GroupDocs para obter uma licença temporária.
  2. Compra: Para acesso total, adquira uma licença no site da GroupDocs.
  3. Licença Temporária: Obtenha‑a para fins de avaliação através do link fornecido.

Inicialização e Configuração Básicas

A classe Index representa um índice pesquisável armazenado em disco e fornece métodos para adicionar, atualizar e consultar documentos. Após a instalação, inicialize seu projeto com as configurações necessárias:

using GroupDocs.Search;
using GroupDocs.Redaction;

// Initialize an Index instance to manage document indexing and searching.
Index index = new Index("path/to/index/folder");

Guia de Implementação

Criando e Indexando Documentos

Visão Geral
Este recurso demonstra como organizar documentos de forma eficiente criando um índice para uma pasta que contém vários arquivos.

Etapa 1: Definir Caminhos

string indexFolder = "YOUR_DOCUMENT_DIRECTORY/ObtainSearchResultInformation";
string documentFolder = "YOUR_DOCUMENT_DIRECTORY/DocumentsPath";

// Create an instance of the Index class.
Index index = new Index(indexFolder);

// Add documents from the specified folder to the index.
index.Add(documentFolder);

Configuração e Execução da Busca Difusa

Visão Geral
A busca difusa permite encontrar documentos mesmo com pequenas discrepâncias nos termos de busca. Este recurso demonstra a configuração de uma busca difusa com precisão ajustável.

Etapa 1: Habilitar Busca Difusa

using GroupDocs.Search.Options;

SearchOptions options = new SearchOptions();
options.FuzzySearch.Enabled = true;
options.FuzzySearch.FuzzyAlgorithm = new TableDiscreteFunction(3); // Allow up to 3 differences

// Execute the search with fuzzy logic.
SearchResult result = index.Search("favourable OR \"ipsum dolor\"", options);

Console.WriteLine("Documents: " + result.DocumentCount);
Console.WriteLine("Total occurrences: " + result.OccurrenceCount);

Destacar Resultados de Busca em Formato HTML

Visão Geral
Destacar resultados de busca marca visualmente as seções relevantes dentro de um arquivo, facilitando a análise rápida.

Etapa 1: Configurar Alta Compressão

using GroupDocs.Search.Highlighters;
using GroupDocs.Search.Options;

IndexSettings settings = new IndexSettings();
settings.TextStorageSettings = new TextStorageSettings(Compression.High);

// Create an instance of the Index.
Index index = new Index(indexFolder, settings);
index.Add(documentFolder);

Etapa 2: Destacar e Gerar Saída

SearchResult result = index.Search("solicitude");

if (result.DocumentCount > 0)
{
    FoundDocument document = result.GetFoundDocument(0);

    string path = "YOUR_OUTPUT_DIRECTORY/Highlighted.html";
    OutputAdapter outputAdapter = new FileOutputAdapter(OutputFormat.Html, path);
    Highlighter highlighter = new DocumentHighlighter(outputAdapter);

    // Generate highlighted HTML content.
    index.Highlight(document, highlighter);
}

Dicas de Solução de Problemas

  • Certifique‑se de que os caminhos estejam especificados corretamente para evitar erros de arquivo não encontrado.
  • Verifique se todas as permissões necessárias para operações de leitura/gravação em diretórios estão definidas.

Aplicações Práticas

  1. Revisão de Documentos Legais – Localize rapidamente termos relacionados a casos em corpora legais massivos.
  2. Pesquisa Acadêmica – Pesquise entre milhares de artigos por metodologias específicas.
  3. Inteligência de Negócios – Extraia métricas chave de relatórios trimestrais sem busca manual.
  4. Suporte ao Cliente – Analise tickets de suporte em busca de problemas recorrentes e redija dados pessoais antes da análise.
  5. Sistemas de Gerenciamento de Conteúdo (CMS) – Melhore a recuperação de conteúdo com busca difusa e redação automática de trechos sensíveis.

Considerações de Desempenho

  • Otimize as configurações de armazenamento do índice para equilibrar velocidade e uso de disco.
  • Atualize os índices regularmente para manter os dados atuais, reduzindo processamento desnecessário.
  • Libere objetos não utilizados prontamente para evitar vazamentos de memória, especialmente ao lidar com grandes lotes.

Como redigir informações sensíveis de um PDF usando o GroupDocs Redaction?

Redactor é a classe principal usada para aplicar padrões de redação aos formatos de documento suportados. Carregue o PDF alvo com Redactor redactor = new Redactor("file.pdf"), defina um padrão de redação (por exemplo, redactor.AddRedaction(new RedactionPhrase("confidential"))), e chame redactor.Apply() – a biblioteca sobrescreve o arquivo original com o conteúdo redigido enquanto preserva o layout. Este fluxo de trabalho de um passo garante que nenhum vestígio da frase protegida permaneça.

Como destacar resultados de busca em HTML após uma consulta difusa?

SearchResultHighlighter fornece utilitários para gerar trechos de HTML destacados a partir de correspondências de busca. Execute a consulta difusa, recupere os fragmentos correspondentes e passe‑os para SearchResultHighlighter.HighlightHtml(matches, "<mark>", "</mark>"). O método envolve cada ocorrência com as tags fornecidas, produzindo um trecho HTML onde cada termo relevante é visualmente enfatizado. O HTML destacado pode ser incorporado diretamente em páginas web ou salvo como relatório, facilitando que os usuários finais vejam o contexto de cada correspondência.

Perguntas Frequentes

Q: O que é busca difusa?
A: A busca difusa encontra correspondências aproximadas, tolerando erros ortográficos ou pequenas variações no termo de consulta.

Q: Posso usar essas bibliotecas em um projeto comercial?
A: Sim, uma licença válida da GroupDocs concede direitos de uso comercial.

Q: Como lidar com grandes conjuntos de documentos de forma eficiente?
A: Use indexação incremental, ajuste IndexingOptions para o tamanho de lote e agende reconstruções regulares do índice para manter o desempenho ideal.

Q: Quais formatos de arquivo são suportados pelo GroupDocs.Search?
A: Mais de 100 formatos são suportados, incluindo PDF, DOCX, XLSX, PPTX, HTML, TXT e tipos de imagem como JPEG e PNG.

Q: Existe suporte multilíngue para busca e redação?
A: Sim, as bibliotecas incluem analisadores de idioma para mais de 30 idiomas, permitindo buscas e redações precisas em conteúdo global.

Recursos


Última Atualização: 2026-07-16
Testado com: GroupDocs.Search 2.0.0 e GroupDocs.Redaction 2.0.0 para .NET
Autor: GroupDocs

Tutoriais Relacionados