Quando un’applicazione .NET viene eseguita su Windows, può usare la build specifica per Windows di GroupDocs.Redaction per .NET. Questa esercitazione mostra come creare un’applicazione console .NET 10 destinata a net10.0-windows, censurare una frase in un documento Word con un’espressione regolare e salvare il documento censurato.

Una versione completa e funzionante del progetto è disponibile su GitHub.

1. Creare un progetto console .NET per Windows

È possibile creare il progetto con Visual Studio o con la CLI .NET. Il progetto deve avere come destinazione net10.0-windows. Per questo framework di destinazione NuGet ripristina l’assembly specifico per Windows GroupDocs.Redaction.Net100.Windows. Questa build include dipendenze specifiche per Windows.

I progetti destinati a net10.0 senza il suffisso -windows usano la build multipiattaforma.

Con Visual Studio

Creare una nuova app console e selezionare .NET 10.0 come framework di destinazione. Dopo aver creato il progetto, aprire il file di progetto e impostare il framework di destinazione:

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

Con la CLI .NET

Creare un’applicazione console .NET 10 e aprire la directory del progetto:

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

Quindi impostare lo stesso framework di destinazione in WindowsSpecificRedaction.csproj:

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

I file del progetto in questo passaggio sono:

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

2. Installare GroupDocs.Redaction 26.10

Aggiungere GroupDocs.Redaction per .NET 26.10.0 con Visual Studio o con la CLI .NET.

Con Visual Studio

  1. Fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni.
  2. Selezionare Gestisci pacchetti NuGet.
  3. Cercare GroupDocs.Redaction e installare la versione 26.10.0.

Con la CLI .NET

Eseguire questo comando dalla directory del progetto:

dotnet add package GroupDocs.Redaction --version 26.10.0

Il pacchetto fornisce la classe Redactor per caricare e salvare i documenti, RegexRedaction per censurare le corrispondenze di un’espressione regolare e la proprietà License.IsLicensed per verificare se è applicata una licenza valida.

3. Aggiungere il file Word

Inserire il documento Word nella directory del progetto e denominarlo:

document.docx

Nel file di progetto configurare la copia del documento nella directory di output della compilazione:

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

Il documento di esempio contiene la frase essential tool. L’applicazione sostituisce la frase corrispondente e crea document_Redacted.docx. Il file originale document.docx rimane invariato.

4. Aggiungere il codice di censura

Aprire Program.cs e sostituirne il contenuto con il codice seguente:

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 proprietà License.IsLicensed restituisce false finché SetLicense non carica una licenza valida. Per eseguire l’applicazione in modalità con licenza, rimuovere il commento dalla chiamata a SetLicense e indicare il percorso del file di licenza.

L’espressione regolare \s+essential tool corrisponde a uno o più caratteri di spazio vuoto seguiti dalla frase essential tool. La ricerca non distingue tra maiuscole e minuscole, quindi corrisponde anche Essential Tool. Ogni corrispondenza, compreso lo spazio prima della frase, viene sostituita con [redacted].

La proprietà RasterizeToPDF è impostata su false, quindi il documento mantiene il formato Word. La proprietà AddSuffix è impostata su true, quindi il file di output viene salvato con il suffisso Redacted:

document_Redacted.docx

Il metodo Save restituisce il percorso del file salvato.

5. Eseguire l’applicazione

Con Visual Studio

  1. Aprire WindowsSpecificRedaction.slnx oppure il file di progetto.
  2. Premere F5 per eseguire il debug oppure Ctrl+F5 per eseguire senza debug.

Quando l’applicazione viene eseguita da Visual Studio, la directory di lavoro è in genere la directory di output della compilazione. Il file censurato viene salvato in:

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

Con la CLI .NET

Eseguire il comando seguente dalla directory del progetto:

dotnet run

Con dotnet run la directory di lavoro è la directory del progetto. L’applicazione legge document.docx da questa directory e salva document_Redacted.docx accanto a esso.

6. Controllare il documento censurato

Aprire document_Redacted.docx. La frase essential tool deve essere sostituita con [redacted]. Il file originale document.docx rimane invariato.

È possibile usare lo stesso progetto per censurare altre frasi modificando l’espressione regolare e il testo di sostituzione.

Licenza

Senza una licenza, GroupDocs.Redaction per .NET 26.10 viene eseguito in modalità di valutazione. Un singolo processo può aprire fino a 25 documenti. Il tentativo di aprire un altro documento genera un’eccezione TrialLimitationsException. I badge di prova vengono aggiunti in cima a ogni pagina dei documenti salvati.

Una licenza temporanea è disponibile nella pagina delle licenze temporanee GroupDocs. Una licenza permanente è disponibile nella pagina di acquisto GroupDocs.

Ulteriori informazioni