Cuando una aplicación .NET se ejecuta en Windows, puede usar la compilación específica de Windows de GroupDocs.Redaction for .NET. Este tutorial muestra cómo crear una aplicación de consola .NET 10 dirigida a net10.0-windows, redactar una frase en un documento Word usando una expresión regular y guardar el documento redactado.

Una versión completa y funcional del proyecto está disponible en GitHub.

1. Crear un proyecto de consola .NET para Windows

Puede crear el proyecto usando Visual Studio o la CLI de .NET. El proyecto debe dirigirse a net10.0-windows. NuGet restaura el ensamblado específico de Windows GroupDocs.Redaction.Net100.Windows para este framework de destino. Esta compilación incluye dependencias específicas de Windows.

Los proyectos dirigidos a net10.0 sin el sufijo -windows usan la compilación multiplataforma.

Usando Visual Studio

Cree una nueva Aplicación de consola y seleccione .NET 10.0 como framework de destino. Después de crear el proyecto, abra el archivo del proyecto y establezca el framework de destino:

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

Usando la CLI de .NET

Cree una aplicación de consola .NET 10 y abra el directorio del proyecto:

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

Luego establezca el mismo framework de destino en WindowsSpecificRedaction.csproj:

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

Los archivos del proyecto en este paso son:

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

2. Instalar GroupDocs.Redaction 26.10

Agregue GroupDocs.Redaction for .NET 26.10.0 usando Visual Studio o la CLI de .NET.

Usando Visual Studio

  1. Haga clic con el botón derecho del ratón en el proyecto en Solution Explorer.
  2. Seleccione Manage NuGet Packages.
  3. Busque GroupDocs.Redaction e instale la versión 26.10.0.

Usando la CLI de .NET

Ejecute este comando desde el directorio del proyecto:

dotnet add package GroupDocs.Redaction --version 26.10.0

El paquete proporciona la clase Redactor para cargar y guardar documentos, RegexRedaction para redactar coincidencias de expresiones regulares y la propiedad License.IsLicensed para comprobar si se ha aplicado una licencia válida.

3. Añadir el archivo Word

Coloque el documento Word en el directorio del proyecto y asígnele el nombre:

document.docx

En el archivo del proyecto, configure el documento para que se copie al directorio de salida de compilación:

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

El documento de ejemplo contiene la frase essential tool. La aplicación reemplaza la frase coincidente y crea document_Redacted.docx. El document.docx original permanece sin cambios.

4. Añadir el código de redacción

Abra Program.cs y reemplace su contenido con el siguiente código:

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}.");
}

La propiedad License.IsLicensed devuelve false hasta que SetLicense cargue una licencia válida. Descomente la llamada a SetLicense y proporcione la ruta a su archivo de licencia para ejecutar la aplicación en modo licenciado.

La expresión regular \s+essential tool coincide con uno o más caracteres de espacio en blanco seguidos de la frase essential tool. La búsqueda no distingue mayúsculas, por lo que Essential Tool también coincide. Cada coincidencia, incluido el espacio antes de la frase, se reemplaza por [redacted].

La propiedad RasterizeToPDF está establecida en false, por lo que el documento conserva su formato Word. La propiedad AddSuffix está establecida en true, por lo que el archivo de salida se guarda con el sufijo Redacted:

document_Redacted.docx

El método Save devuelve la ruta al archivo guardado.

5. Ejecutar la aplicación

Usando Visual Studio

  1. Abra WindowsSpecificRedaction.slnx, o abra el archivo del proyecto.
  2. Pulse F5 para depurar o Ctrl+F5 para ejecutar sin depuración.

Al ejecutar la aplicación desde Visual Studio, el directorio de trabajo suele ser el directorio de salida de compilación. El archivo redactado se guarda en:

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

Usando la CLI de .NET

Ejecute el siguiente comando desde el directorio del proyecto:

dotnet run

Al usar dotnet run, el directorio de trabajo es el directorio del proyecto. La aplicación lee document.docx desde este directorio y guarda document_Redacted.docx junto a él.

6. Verificar el documento redactado

Abra document_Redacted.docx. La frase essential tool debería haber sido reemplazada por [redacted]. El document.docx original permanece sin cambios.

Puede usar el mismo proyecto para redactar otras frases modificando la expresión regular y el texto de reemplazo.

Licenciamiento

Sin una licencia, GroupDocs.Redaction for .NET 26.10 se ejecuta en modo de evaluación. Un solo proceso puede abrir hasta 25 documentos. Intentar abrir otro documento lanza una TrialLimitationsException. Los sellos de prueba se añaden a la parte superior de cada página en los documentos guardados.

Una licencia temporal está disponible en la página de licencias temporales de GroupDocs. Una licencia permanente está disponible en la página de compra de GroupDocs.

Más información