Lorsque une application .NET s’exécute sous Windows, elle peut utiliser la version spécifique à Windows de GroupDocs.Redaction for .NET. Ce tutoriel montre comment créer une application console .NET 10 ciblant net10.0-windows, masquer une phrase dans un document Word à l’aide d’une expression régulière et enregistrer le document masqué.

Une version complète et fonctionnelle du projet est disponible sur GitHub.

1. Créer un projet console .NET pour Windows

Vous pouvez créer le projet avec Visual Studio ou la CLI .NET. Le projet doit cibler net10.0-windows. NuGet restaure l’assembly spécifique à Windows GroupDocs.Redaction.Net100.Windows pour ce framework cible. Cette version comprend les dépendances propres à Windows.

Les projets ciblant net10.0 sans le suffixe -windows utilisent la version multiplateforme.

Avec Visual Studio

Créez une nouvelle application Console et sélectionnez .NET 10.0 comme framework cible. Après la création du projet, ouvrez le fichier projet et définissez le framework cible :

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

Avec la CLI .NET

Créez une application console .NET 10 et ouvrez le répertoire du projet :

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

Puis définissez le même framework cible dans WindowsSpecificRedaction.csproj :

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

Les fichiers du projet à cette étape sont :

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

2. Installer GroupDocs.Redaction 26.10

Ajoutez GroupDocs.Redaction for .NET 26.10.0 avec Visual Studio ou la CLI .NET.

Avec Visual Studio

  1. Faites un clic droit sur le projet dans Solution Explorer.
  2. Sélectionnez Manage NuGet Packages.
  3. Recherchez GroupDocs.Redaction et installez la version 26.10.0.

Avec la CLI .NET

Exécutez la commande suivante depuis le répertoire du projet :

dotnet add package GroupDocs.Redaction --version 26.10.0

Le package fournit la classe Redactor pour charger et enregistrer des documents, RegexRedaction pour masquer les correspondances d’expression régulière, et la propriété License.IsLicensed pour vérifier si une licence valide est appliquée.

3. Ajouter le fichier Word

Placez le document Word dans le répertoire du projet et nommez‑le :

document.docx

Dans le fichier projet, configurez le document pour qu’il soit copié dans le répertoire de sortie :

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

Le document d’exemple contient la phrase essential tool. L’application remplace la phrase correspondante et crée document_Redacted.docx. Le fichier original document.docx reste inchangé.

4. Ajouter le code de masquage

Ouvrez Program.cs et remplacez son contenu par le code suivant :

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 propriété License.IsLicensed renvoie false tant que SetLicense n’a pas chargé une licence valide. Décommentez l’appel à SetLicense et indiquez le chemin de votre fichier de licence pour exécuter l’application en mode licencié.

L’expression régulière \s+essential tool correspond à un ou plusieurs caractères d’espace suivis de la phrase essential tool. La recherche est insensible à la casse, donc Essential Tool correspond également. Chaque correspondance, y compris l’espace précédant la phrase, est remplacée par [redacted].

La propriété RasterizeToPDF est définie sur false, de sorte que le document conserve son format Word. La propriété AddSuffix est définie sur true, ce qui fait que le fichier de sortie est enregistré avec le suffixe Redacted :

document_Redacted.docx

La méthode Save renvoie le chemin du fichier enregistré.

5. Exécuter l’application

Avec Visual Studio

  1. Ouvrez WindowsSpecificRedaction.slnx, ou ouvrez le fichier projet.
  2. Appuyez sur F5 pour déboguer ou Ctrl+F5 pour exécuter sans débogage.

Lorsque l’application est exécutée depuis Visual Studio, le répertoire de travail est généralement le répertoire de sortie de la compilation. Le fichier masqué est enregistré dans :

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

Avec la CLI .NET

Exécutez la commande suivante depuis le répertoire du projet :

dotnet run

Avec dotnet run, le répertoire de travail est le répertoire du projet. L’application lit document.docx depuis ce répertoire et enregistre document_Redacted.docx à côté.

6. Vérifier le document masqué

Ouvrez document_Redacted.docx. La phrase essential tool doit être remplacée par [redacted]. Le fichier original document.docx reste inchangé.

Vous pouvez utiliser le même projet pour masquer d’autres phrases en modifiant l’expression régulière et le texte de remplacement.

Licence

Sans licence, GroupDocs.Redaction for .NET 26.10 fonctionne en mode évaluation. Un seul processus peut ouvrir jusqu’à 25 documents. Tenter d’ouvrir un autre document déclenche une TrialLimitationsException. Des badges d’évaluation sont ajoutés en haut de chaque page des documents enregistrés.

Une licence temporaire est disponible sur la page de licence temporaire GroupDocs. Une licence permanente est disponible sur la page d’achat GroupDocs.

En savoir plus