Kiedy aplikacja .NET uruchamiana jest w systemie Windows, może korzystać z wersji specyficznej dla Windows GroupDocs.Redaction for .NET. Ten samouczek pokazuje, jak utworzyć aplikację konsolową .NET 10 skierowaną do net10.0-windows, usunąć frazę w dokumencie Word przy użyciu wyrażenia regularnego oraz zapisać zredagowany dokument.

Kompletny działający projekt dostępny jest w repozytorium GitHub.

1. Utworzenie projektu .NET Console dla Windows

Projekt można utworzyć w Visual Studio lub przy pomocy .NET CLI. Projekt musi celować w net10.0-windows. NuGet przywróci specyficzny dla Windows zestaw GroupDocs.Redaction.Net100.Windows dla tego frameworka. Ta wersja zawiera zależności charakterystyczne dla Windows.

Projekty celujące w net10.0 bez przyrostka -windows używają wersji wieloplatformowej.

Korzystanie z Visual Studio

Utwórz nową aplikację konsolową i wybierz .NET 10.0 jako docelowy framework. Po utworzeniu projektu otwórz plik projektu i ustaw docelowy framework:

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

Korzystanie z .NET CLI

Utwórz aplikację konsolową .NET 10 i przejdź do katalogu projektu:

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

Następnie ustaw ten sam docelowy framework w WindowsSpecificRedaction.csproj:

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

Pliki projektu na tym etapie wyglądają tak:

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

2. Instalacja GroupDocs.Redaction 26.10

Dodaj GroupDocs.Redaction for .NET 26.10.0 przy użyciu Visual Studio lub .NET CLI.

Korzystanie z Visual Studio

  1. Kliknij prawym przyciskiem myszy projekt w Solution Explorer.
  2. Wybierz Manage NuGet Packages.
  3. Wyszukaj GroupDocs.Redaction i zainstaluj wersję 26.10.0.

Korzystanie z .NET CLI

Wykonaj poniższe polecenie w katalogu projektu:

dotnet add package GroupDocs.Redaction --version 26.10.0

Pakiet udostępnia klasę Redactor do ładowania i zapisywania dokumentów, RegexRedaction do usuwania dopasowań wyrażeń regularnych oraz właściwość License.IsLicensed służącą do sprawdzania, czy zastosowano ważną licencję.

3. Dodanie pliku Word

Umieść dokument Word w katalogu projektu i nazwij go:

document.docx

W pliku projektu skonfiguruj kopiowanie dokumentu do katalogu wyjściowego kompilacji:

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

Przykładowy dokument zawiera frazę essential tool. Aplikacja zamieni tę frazę i utworzy plik document_Redacted.docx. Oryginalny document.docx pozostanie niezmieniony.

4. Dodanie kodu redakcji

Otwórz Program.cs i zamień jego zawartość na poniższy kod:

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

Właściwość License.IsLicensed zwraca false, dopóki metoda SetLicense nie załaduje ważnej licencji. Odkomentuj wywołanie SetLicense i podaj ścieżkę do pliku licencji, aby uruchomić aplikację w trybie licencjonowanym.

Wyrażenie regularne \s+essential tool dopasowuje jedną lub więcej białych znaków poprzedzających frazę essential tool. Wyszukiwanie jest nieczułe na wielkość liter, więc dopasuje także Essential Tool. Każde dopasowanie, łącznie z białym znakiem przed frazą, zostaje zastąpione ciągiem [redacted].

Właściwość RasterizeToPDF jest ustawiona na false, więc dokument zachowuje format Word. Właściwość AddSuffix jest ustawiona na true, więc plik wyjściowy zostaje zapisany z przyrostkiem Redacted:

document_Redacted.docx

Metoda Save zwraca ścieżkę do zapisanego pliku.

5. Uruchomienie aplikacji

Korzystanie z Visual Studio

  1. Otwórz WindowsSpecificRedaction.slnx lub sam plik projektu.
  2. Naciśnij F5, aby debugować, lub Ctrl+F5, aby uruchomić bez debugowania.

Podczas uruchamiania z Visual Studio katalog roboczy to zazwyczaj katalog wyjściowy kompilacji. Zredagowany plik zostaje zapisany w:

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

Korzystanie z .NET CLI

Wykonaj następujące polecenie w katalogu projektu:

dotnet run

Przy użyciu dotnet run katalogiem roboczym jest katalog projektu. Aplikacja odczytuje document.docx z tego katalogu i zapisuje document_Redacted.docx obok niego.

6. Sprawdzenie zredagowanego dokumentu

Otwórz document_Redacted.docx. Fraza essential tool powinna zostać zamieniona na [redacted]. Oryginalny document.docx pozostaje niezmieniony.

Ten sam projekt można wykorzystać do usuwania innych fraz, modyfikując wyrażenie regularne i tekst zastępczy.

Licencjonowanie

Bez licencji GroupDocs.Redaction for .NET 26.10 działa w trybie ewaluacyjnym. Jeden proces może otworzyć maksymalnie 25 dokumentów. Próba otwarcia kolejnego dokumentu powoduje wyrzucenie TrialLimitationsException. W zapisanych dokumentach na górze każdej strony pojawiają się tymczasowe odznaki.

Tymczasowa licencja jest dostępna na stronie licencji tymczasowej GroupDocs. Licencja stała jest dostępna na stronie zakupu GroupDocs.

Dowiedz się więcej