Wenn eine .NET‑Anwendung unter Windows läuft, kann sie die Windows‑spezifische Build von GroupDocs.Redaction for .NET verwenden. Dieses Tutorial zeigt, wie man eine .NET 10 Konsolenanwendung erstellt, die net10.0-windows zielt, einen Ausdruck in einem Word‑Dokument mithilfe eines regulären Ausdrucks redigiert und das redigierte Dokument speichert.

Eine vollständige, funktionierende Version des Projekts ist auf GitHub verfügbar.

1. Erstellen eines .NET‑Konsolenprojekts für Windows

Sie können das Projekt mit Visual Studio oder der .NET‑CLI erstellen. Das Projekt muss net10.0-windows als Ziel‑Framework verwenden. NuGet stellt die Windows‑spezifische GroupDocs.Redaction.Net100.Windows‑Assembly für dieses Ziel‑Framework bereit. Diese Build enthält Windows‑spezifische Abhängigkeiten.

Projekte, die net10.0 ohne das Suffix -windows anvisieren, verwenden die plattformübergreifende Build.

Verwenden von Visual Studio

Erstellen Sie eine neue Konsolen‑App und wählen Sie .NET 10.0 als Ziel‑Framework. Nach dem Erstellen des Projekts öffnen Sie die Projektdatei und setzen das Ziel‑Framework:

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

Verwenden der .NET‑CLI

Erstellen Sie eine .NET 10 Konsolenanwendung und öffnen Sie das Projektverzeichnis:

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

Setzen Sie dann dasselbe Ziel‑Framework in WindowsSpecificRedaction.csproj:

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

Die Projektdateien in diesem Schritt sind:

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

2. Installieren von GroupDocs.Redaction 26.10

Fügen Sie GroupDocs.Redaction for .NET 26.10.0 über Visual Studio oder die .NET‑CLI hinzu.

Verwenden von Visual Studio

  1. Klicken Sie mit der rechten Maustaste auf das Projekt im Solution Explorer.
  2. Wählen Sie Manage NuGet Packages.
  3. Suchen Sie nach GroupDocs.Redaction und installieren Sie die Version 26.10.0.

Verwenden der .NET‑CLI

Führen Sie diesen Befehl im Projektverzeichnis aus:

dotnet add package GroupDocs.Redaction --version 26.10.0

Das Paket stellt die Klasse Redactor zum Laden und Speichern von Dokumenten, RegexRedaction zum Redigieren von regulären Ausdruck‑Übereinstimmungen und die Eigenschaft License.IsLicensed zum Prüfen, ob eine gültige Lizenz angewendet wurde, bereit.

3. Hinzufügen der Word‑Datei

Platzieren Sie das Word‑Dokument im Projektverzeichnis und benennen Sie es:

document.docx

Konfigurieren Sie in der Projektdatei, dass das Dokument in das Build‑Ausgabeverzeichnis kopiert wird:

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

Das Beispiel‑Dokument enthält den Ausdruck essential tool. Die Anwendung ersetzt den passenden Ausdruck und erstellt document_Redacted.docx. Die ursprüngliche document.docx bleibt unverändert.

4. Hinzufügen des Redaktions‑Codes

Öffnen Sie Program.cs und ersetzen Sie den Inhalt durch den folgenden 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}.");
}

Die Eigenschaft License.IsLicensed liefert false, bis SetLicense eine gültige Lizenz lädt. Kommentieren Sie den Aufruf von SetLicense aus und geben Sie den Pfad zu Ihrer Lizenzdatei an, um die Anwendung im lizenzierten Modus auszuführen.

Der reguläre Ausdruck \s+essential tool entspricht einem oder mehreren Leerzeichen, gefolgt von dem Ausdruck essential tool. Die Suche ist case‑insensitive, sodass auch Essential Tool gefunden wird. Jede Übereinstimmung, einschließlich des Leerzeichens vor dem Ausdruck, wird durch [redacted] ersetzt.

Die Eigenschaft RasterizeToPDF ist auf false gesetzt, sodass das Dokument sein Word‑Format behält. Die Eigenschaft AddSuffix ist auf true gesetzt, sodass die Ausgabedatei mit dem Suffix Redacted gespeichert wird:

document_Redacted.docx

Die Methode Save gibt den Pfad zur gespeicherten Datei zurück.

5. Ausführen der Anwendung

Verwenden von Visual Studio

  1. Öffnen Sie WindowsSpecificRedaction.slnx oder die Projektdatei.
  2. Drücken Sie F5, um zu debuggen, oder Ctrl+F5, um ohne Debugging zu starten.

Beim Ausführen der Anwendung aus Visual Studio ist das Arbeitsverzeichnis typischerweise das Build‑Ausgabeverzeichnis. Die redigierte Datei wird gespeichert unter:

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

Verwenden der .NET‑CLI

Führen Sie den folgenden Befehl im Projektverzeichnis aus:

dotnet run

Bei dotnet run ist das Arbeitsverzeichnis das Projektverzeichnis. Die Anwendung liest document.docx aus diesem Verzeichnis und speichert document_Redacted.docx daneben.

6. Überprüfen des redigierten Dokuments

Öffnen Sie document_Redacted.docx. Der Ausdruck essential tool sollte durch [redacted] ersetzt sein. Die ursprüngliche document.docx bleibt unverändert.

Sie können dasselbe Projekt verwenden, um andere Ausdrücke zu redigieren, indem Sie den regulären Ausdruck und den Ersetzungstext anpassen.

Lizenzierung

Ohne Lizenz läuft GroupDocs.Redaction for .NET 26.10 im Evaluierungsmodus. Ein einzelner Prozess kann bis zu 25 Dokumente öffnen. Der Versuch, ein weiteres Dokument zu öffnen, löst eine TrialLimitationsException aus. Prüf‑Badges werden oben auf jeder Seite in gespeicherten Dokumenten hinzugefügt.

Eine temporäre Lizenz ist auf der GroupDocs-Seite für temporäre Lizenzen verfügbar. Eine permanente Lizenz ist auf der GroupDocs-Kaufseite erhältlich.

Weitere Informationen