Když se aplikace .NET spouští ve Windows, může použít specifickou verzi pro Windows GroupDocs.Redaction for .NET. Tento tutoriál ukazuje, jak vytvořit konzolovou aplikaci .NET 10 cílenou na net10.0-windows, jak zakrýt frázi ve Word dokumentu pomocí regulárního výrazu a jak uložit zakrytý dokument.
Kompletní funkční verze projektu je k dispozici na GitHub.
1. Vytvoření .NET konzolového projektu pro Windows
Projekt můžete vytvořit pomocí Visual Studia nebo .NET CLI. Projekt musí cílit na net10.0-windows. NuGet obnoví Windows‑specifické sestavení GroupDocs.Redaction.Net100.Windows pro tento cílový framework. Toto sestavení obsahuje Windows‑specifické závislosti.
Projekty cílící na net10.0 bez přípony -windows používají multiplatformní verzi.
Použití Visual Studia
Vytvořte novou Console App a jako cílový framework vyberte .NET 10.0. Po vytvoření projektu otevřete soubor projektu a nastavte cílový framework:
<TargetFramework>net10.0-windows</TargetFramework>
Použití .NET CLI
Vytvořte .NET 10 konzolovou aplikaci a otevřete adresář projektu:
dotnet new console -n WindowsSpecificRedaction -f net10.0
cd WindowsSpecificRedaction
Poté nastavte stejný cílový framework v WindowsSpecificRedaction.csproj:
<TargetFramework>net10.0-windows</TargetFramework>
Soubory projektu v tomto kroku jsou:
WindowsSpecificRedaction/
├── WindowsSpecificRedaction.csproj
└── Program.cs
2. Instalace GroupDocs.Redaction 26.10
Přidejte GroupDocs.Redaction for .NET 26.10.0 pomocí Visual Studia nebo .NET CLI.
Použití Visual Studia
- Klikněte pravým tlačítkem na projekt v Solution Explorer.
- Vyberte Manage NuGet Packages.
- Vyhledejte
GroupDocs.Redactiona nainstalujte verzi 26.10.0.
Použití .NET CLI
Spusťte tento příkaz v adresáři projektu:
dotnet add package GroupDocs.Redaction --version 26.10.0
Balíček poskytuje třídu Redactor pro načítání a ukládání dokumentů, RegexRedaction pro zakrytí shod regulárních výrazů a vlastnost License.IsLicensed pro kontrolu, zda je použita platná licence.
3. Přidání Word souboru
Umístěte Word dokument do adresáře projektu a pojmenujte jej:
document.docx
V souboru projektu nakonfigurujte, aby se dokument kopíroval do výstupního adresáře sestavení:
<ItemGroup>
<None Update="document.docx">
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
</None>
</ItemGroup>
Ukázkový dokument obsahuje frázi essential tool. Aplikace nahradí tuto frázi a vytvoří document_Redacted.docx. Původní document.docx zůstane nezměněn.
4. Přidání kódu pro zakrytí
Otevřete Program.cs a nahraďte jeho obsah následujícím kódem:
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}.");
}
Vlastnost License.IsLicensed vrací false, dokud SetLicense nenačte platnou licenci. Odkomentujte volání SetLicense a zadejte cestu k souboru licence, abyste aplikaci spustili v licencovaném režimu.
Regulární výraz \s+essential tool odpovídá jedné nebo více mezerám následovaným frází essential tool. Vyhledávání je necitlivé na velikost písmen, takže se shodí i Essential Tool. Každá shoda, včetně mezer před frází, je nahrazena [redacted].
Vlastnost RasterizeToPDF je nastavena na false, takže dokument zachová svůj Word formát. Vlastnost AddSuffix je nastavena na true, takže výstupní soubor bude uložen s příponou Redacted:
document_Redacted.docx
Metoda Save vrací cestu k uloženému souboru.
5. Spuštění aplikace
Použití Visual Studia
- Otevřete
WindowsSpecificRedaction.slnxnebo soubor projektu. - Stiskněte F5 pro ladění nebo Ctrl+F5 pro spuštění bez ladění.
Při spuštění aplikace z Visual Studia je pracovní adresář obvykle výstupní adresář sestavení. Zakrytý soubor je uložen do:
bin\Debug\net10.0-windows\document_Redacted.docx
Použití .NET CLI
Spusťte následující příkaz v adresáři projektu:
dotnet run
Při použití dotnet run je pracovní adresář adresář projektu. Aplikace načte document.docx z tohoto adresáře a uloží document_Redacted.docx vedle něj.
6. Kontrola zakrytého dokumentu
Otevřete document_Redacted.docx. Fráze essential tool by měla být nahrazena [redacted]. Původní document.docx zůstane nezměněn.
Stejný projekt můžete použít k zakrytí dalších frází úpravou regulárního výrazu a textu náhrady.
Licencování
Bez licence běží GroupDocs.Redaction for .NET 26.10 v evaluačním režimu. Jeden proces může otevřít až 25 dokumentů. Pokus o otevření dalšího dokumentu vyvolá výjimku TrialLimitationsException. Zkušební odznaky jsou přidány na vrchol každé stránky v uložených dokumentech.
Dočasná licence je k dispozici na stránce dočasné licence GroupDocs. Trvalá licence je k dispozici na stránce nákupu GroupDocs.