Quando uma aplicação .NET é executada no Windows, ela pode usar a compilação específica para Windows do GroupDocs.Redaction for .NET. Este tutorial mostra como criar uma aplicação console .NET 10 direcionada a net10.0-windows, redigir uma frase em um documento Word usando uma expressão regular e salvar o documento redigido.

Uma versão completa e funcional do projeto está disponível no GitHub.

1. Criar um Projeto Console .NET para Windows

Você pode criar o projeto usando o Visual Studio ou a .NET CLI. O projeto deve direcionar net10.0-windows. O NuGet restaura o assembly específico para Windows GroupDocs.Redaction.Net100.Windows para esse framework de destino. Essa compilação inclui dependências específicas do Windows.

Projetos que direcionam net10.0 sem o sufixo -windows usam a compilação multiplataforma.

Usando o Visual Studio

Crie um novo Console App e selecione .NET 10.0 como framework de destino. Após criar o projeto, abra o arquivo de projeto e defina o framework de destino:

<TargetFramework>net10.0-windows</TargetFramework>

Usando a .NET CLI

Crie uma aplicação console .NET 10 e abra o diretório do projeto:

dotnet new console -n WindowsSpecificRedaction -f net10.0
cd WindowsSpecificRedaction

Em seguida, defina o mesmo framework de destino em WindowsSpecificRedaction.csproj:

<TargetFramework>net10.0-windows</TargetFramework>

Os arquivos do projeto neste passo são:

WindowsSpecificRedaction/
├── WindowsSpecificRedaction.csproj
└── Program.cs

2. Instalar GroupDocs.Redaction 26.10

Adicione GroupDocs.Redaction for .NET 26.10.0 usando o Visual Studio ou a .NET CLI.

Usando o Visual Studio

  1. Clique com o botão direito no projeto em Solution Explorer.
  2. Selecione Manage NuGet Packages.
  3. Procure por GroupDocs.Redaction e instale a versão 26.10.0.

Usando a .NET CLI

Execute este comando a partir do diretório do projeto:

dotnet add package GroupDocs.Redaction --version 26.10.0

O pacote fornece a classe Redactor para carregar e salvar documentos, RegexRedaction para redigir correspondências de expressões regulares e a propriedade License.IsLicensed para verificar se uma licença válida foi aplicada.

3. Adicionar o Arquivo Word

Coloque o documento Word no diretório do projeto e nomeie‑o:

document.docx

No arquivo de projeto, configure o documento para ser copiado para o diretório de saída da compilação:

<ItemGroup>
  <None Update="document.docx">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  </None>
</ItemGroup>

O documento de exemplo contém a frase essential tool. A aplicação substitui a frase correspondente e cria document_Redacted.docx. O document.docx original permanece inalterado.

4. Adicionar o Código de Redação

Abra Program.cs e substitua seu conteúdo pelo código a seguir:

using GroupDocs.Redaction;
using GroupDocs.Redaction.Options;
using GroupDocs.Redaction.Redactions;
using System.Text.RegularExpressions;

var license = new License();
// license.SetLicense("your_license_path");

if (!license.IsLicensed)
{
    Console.WriteLine("The library is running in evaluation mode. Some limitations may apply.");
}

using (Redactor redactor = new Redactor("document.docx"))
{
    var regex = new Regex(@"\s+essential tool", RegexOptions.IgnoreCase);
    redactor.Apply(new RegexRedaction(regex, new ReplacementOptions(" [redacted]")));

    var saveOptions = new SaveOptions() { AddSuffix = true, RasterizeToPDF = false };
    var outputFile = redactor.Save(saveOptions);

    Console.WriteLine($"File saved to {outputFile}.");
}

A propriedade License.IsLicensed retorna false até que SetLicense carregue uma licença válida. Descomente a chamada SetLicense e forneça o caminho para o seu arquivo de licença para executar a aplicação em modo licenciado.

A expressão regular \s+essential tool corresponde a um ou mais caracteres de espaço em branco seguidos da frase essential tool. A busca não diferencia maiúsculas de minúsculas, portanto Essential Tool também corresponde. Cada correspondência, incluindo o espaço em branco antes da frase, é substituída por [redacted].

A propriedade RasterizeToPDF está definida como false, portanto o documento mantém seu formato Word. A propriedade AddSuffix está definida como true, de modo que o arquivo de saída é salvo com o sufixo Redacted:

document_Redacted.docx

O método Save devolve o caminho para o arquivo salvo.

5. Executar a Aplicação

Usando o Visual Studio

  1. Abra WindowsSpecificRedaction.slnx ou abra o arquivo de projeto.
  2. Pressione F5 para depurar ou Ctrl+F5 para executar sem depuração.

Ao executar a aplicação pelo Visual Studio, o diretório de trabalho costuma ser o diretório de saída da compilação. O arquivo redigido é salvo em:

bin\Debug\net10.0-windows\document_Redacted.docx

Usando a .NET CLI

Execute o seguinte comando a partir do diretório do projeto:

dotnet run

Ao usar dotnet run, o diretório de trabalho é o diretório do projeto. A aplicação lê document.docx desse diretório e salva document_Redacted.docx ao lado dele.

6. Verificar o Documento Redigido

Abra document_Redacted.docx. A frase essential tool deve ter sido substituída por [redacted]. O document.docx original permanece inalterado.

Você pode usar o mesmo projeto para redigir outras frases modificando a expressão regular e o texto de substituição.

Licenciamento

Sem uma licença, GroupDocs.Redaction for .NET 26.10 funciona em modo de avaliação. Um único processo pode abrir até 25 documentos. Tentar abrir outro documento gera uma TrialLimitationsException. Selos de avaliação são adicionados ao topo de cada página nos documentos salvos.

Uma licença temporária está disponível na página de licença temporária da GroupDocs. Uma licença permanente está disponível na página de compra da GroupDocs.

Saiba mais