Wanneer een .NET‑applicatie op Windows wordt uitgevoerd, kan deze de Windows‑specifieke build van GroupDocs.Redaction for .NET gebruiken. Deze tutorial laat zien hoe je een .NET 10 console‑applicatie maakt die net10.0-windows target, een zin in een Word‑document roodt met een reguliere expressie, en het geredigeerde document opslaat.

Een volledig werkende versie van het project is beschikbaar op GitHub.

1. Maak een .NET Console‑project voor Windows

Je kunt het project maken met Visual Studio of de .NET CLI. Het project moet targeten net10.0-windows. NuGet herstelt de Windows‑specifieke GroupDocs.Redaction.Net100.Windows assembly voor dit doel‑framework. Deze build bevat Windows‑specifieke afhankelijkheden.

Projecten die targeten net10.0 zonder de -windows suffix gebruiken de cross‑platform build.

Visual Studio gebruiken

Maak een nieuwe Console App en selecteer .NET 10.0 als target‑framework. Na het aanmaken van het project, open het project‑bestand en stel het target‑framework in:

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

De .NET CLI gebruiken

Maak een .NET 10 console‑applicatie en open de projectmap:

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

Stel vervolgens hetzelfde target‑framework in WindowsSpecificRedaction.csproj in:

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

De projectbestanden op dit punt zijn:

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

2. Installeer GroupDocs.Redaction 26.10

Voeg GroupDocs.Redaction for .NET 26.10.0 toe via Visual Studio of de .NET CLI.

Visual Studio gebruiken

  1. Klik met de rechtermuisknop op het project in Solution Explorer.
  2. Selecteer Manage NuGet Packages.
  3. Zoek naar GroupDocs.Redaction en installeer versie 26.10.0.

De .NET CLI gebruiken

Voer dit commando uit in de projectmap:

dotnet add package GroupDocs.Redaction --version 26.10.0

Het pakket levert de Redactor‑klasse voor het laden en opslaan van documenten, RegexRedaction voor het roodden van reguliere‑expressie‑overeenkomsten, en de License.IsLicensed‑eigenschap om te controleren of een geldige licentie is toegepast.

3. Voeg het Word‑bestand toe

Plaats het Word‑document in de projectmap en noem het:

document.docx

Configureer in het project‑bestand dat het document gekopieerd moet worden naar de build‑outputmap:

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

Het voorbeeld‑document bevat de zin essential tool. De applicatie vervangt de overeenkomstige zin en maakt document_Redacted.docx. Het originele document.docx blijft ongewijzigd.

4. Voeg de redactiecode toe

Open Program.cs en vervang de inhoud door de volgende code:

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

De License.IsLicensed‑eigenschap geeft false terug totdat SetLicense een geldige licentie laadt. Verwijder de commentaartekens bij de SetLicense‑aanroep en geef het pad naar je licentiebestand op om de applicatie in gelicentieerde modus uit te voeren.

De reguliere expressie \s+essential tool komt overeen met één of meer witruimte‑tekens gevolgd door de zin essential tool. De zoekopdracht is niet‑hoofdlettergevoelig, dus Essential Tool wordt ook gevonden. Elke overeenkomst, inclusief de witruimte vóór de zin, wordt vervangen door [redacted].

De RasterizeToPDF‑eigenschap staat op false, zodat het document zijn Word‑formaat behoudt. De AddSuffix‑eigenschap staat op true, zodat het uitvoerbestand wordt opgeslagen met het Redacted‑achtervoegsel:

document_Redacted.docx

De Save‑methode retourneert het pad naar het opgeslagen bestand.

5. Voer de applicatie uit

Visual Studio gebruiken

  1. Open WindowsSpecificRedaction.slnx, of open het project‑bestand.
  2. Druk op F5 om te debuggen of Ctrl+F5 om zonder debuggen uit te voeren.

Wanneer de applicatie vanuit Visual Studio wordt uitgevoerd, is de werkmap doorgaans de build‑outputmap. Het geredigeerde bestand wordt opgeslagen in:

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

De .NET CLI gebruiken

Voer het volgende commando uit in de projectmap:

dotnet run

Bij gebruik van dotnet run is de werkmap de projectmap. De applicatie leest document.docx uit deze map en slaat document_Redacted.docx ernaast op.

6. Controleer het geredigeerde document

Open document_Redacted.docx. De zin essential tool moet vervangen zijn door [redacted]. Het originele document.docx blijft ongewijzigd.

Je kunt hetzelfde project gebruiken om andere zinnen te roodden door de reguliere expressie en de vervangende tekst aan te passen.

Licenties

Zonder licentie draait GroupDocs.Redaction for .NET 26.10 in evaluatiemodus. Eén proces kan maximaal 25 documenten openen. Pogingen om een extra document te openen veroorzaken een TrialLimitationsException. Proef‑badges worden bovenaan elke pagina in opgeslagen documenten toegevoegd.

Een tijdelijke licentie is beschikbaar op de GroupDocs-pagina voor tijdelijke licenties. Een permanente licentie is beschikbaar op de GroupDocs-aankooppagina.

Meer informatie