כאשר יישום .NET פועל ב‑Windows, הוא יכול להשתמש בבנייה המיועדת ל‑Windows של GroupDocs.Redaction for .NET. מדריך זה מציג כיצד ליצור יישום קונסול .NET 10 המיועד ל‑net10.0-windows, למחוק (redact) ביטוי במסמך Word באמצעות ביטוי רגולרי, ולשמור את המסמך המוחק.

גרסה מלאה של הפרויקט זמינה ב‑GitHub.

1. יצירת פרויקט קונסול .NET עבור Windows

ניתן ליצור את הפרויקט באמצעות Visual Studio או באמצעות .NET CLI. על הפרויקט להיות ממוקד ב‑net10.0-windows. NuGet משחזר את האסמבלייה GroupDocs.Redaction.Net100.Windows המיועדת ל‑Windows עבור מסגרת יעד זו. בנייה זו כוללת תלותיות ספציפיות ל‑Windows.

פרויקטים הממוקדים ב‑net10.0 ללא הסיומת -windows משתמשים בבנייה חוצת‑פלטפורמות.

באמצעות Visual Studio

צור אפליקציית Console חדשה ובחר .NET 10.0 כ‑framework יעד. לאחר יצירת הפרויקט, פתח את קובץ הפרויקט והגדר את מסגרת היעד:

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

באמצעות .NET CLI

צור יישום קונסול .NET 10 ופתח את תיקיית הפרויקט:

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

לאחר מכן הגדר את אותה מסגרת יעד ב‑WindowsSpecificRedaction.csproj:

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

קבצי הפרויקט בשלב זה הם:

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

2. התקנת GroupDocs.Redaction 26.10

הוסף GroupDocs.Redaction for .NET 26.10.0 באמצעות Visual Studio או .NET CLI.

באמצעות Visual Studio

  1. לחץ לחיצה ימנית על הפרויקט ב‑Solution Explorer.
  2. בחר Manage NuGet Packages.
  3. חפש GroupDocs.Redaction והתקן גרסה 26.10.0.

באמצעות .NET CLI

הפעל את הפקודה הבאה מתיקיית הפרויקט:

dotnet add package GroupDocs.Redaction --version 26.10.0

החבילה מספקת את המחלקה Redactor לטעינה ושמירת מסמכים, את RegexRedaction למחיקת התאמות של ביטויים רגולריים, ואת המאפיין License.IsLicensed לבדיקת האם חלה רישיון תקף.

3. הוספת קובץ ה‑Word

העתק את קובץ ה‑Word לתיקיית הפרויקט ושם אותו:

document.docx

בקובץ הפרויקט, הגדר שהקובץ יועתק לתיקיית הפלט של הבנייה:

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

המסמך לדוגמה מכיל את הביטוי essential tool. היישום מחליף את הביטוי המתאים ויוצר document_Redacted.docx. הקובץ המקורי document.docx נשאר ללא שינוי.

4. הוספת קוד המחיקה

פתח את Program.cs והחלף את תוכנו בקוד הבא:

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

המאפיין License.IsLicensed מחזיר false עד ש‑SetLicense טוען רישיון תקף. בטל את ההערה על קריאת SetLicense וספק את הנתיב לקובץ הרישיון כדי להריץ את היישום במצב מורשה.

הביטוי הרגולרי \s+essential tool תופס רווח (או יותר) לפני הביטוי essential tool. החיפוש אינו רגיש לרישיות, ולכן גם Essential Tool יתפס. כל התאמה, כולל הרווח שלפני הביטוי, מוחלפת ב‑ [redacted].

המאפיין RasterizeToPDF מוגדר ל‑false, ולכן המסמך נשאר בפורמט Word. המאפיין AddSuffix מוגדר ל‑true, ולכן קובץ הפלט נשמר עם הסיומת Redacted:

document_Redacted.docx

מתודת Save מחזירה את הנתיב לקובץ שנשמר.

5. הרצת היישום

באמצעות Visual Studio

  1. פתח את WindowsSpecificRedaction.slnx, או פתח את קובץ הפרויקט.
  2. לחץ F5 כדי לבצע דיבוג או Ctrl+F5 כדי להריץ ללא דיבוג.

כאשר מריצים את היישום מ‑Visual Studio, ספריית העבודה היא בדרך כלל תיקיית הפלט של הבנייה. הקובץ המוחק נשמר ב‑:

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

באמצעות .NET CLI

הפעל את הפקודה הבאה מתיקיית הפרויקט:

dotnet run

כאשר משתמשים ב‑dotnet run, ספריית העבודה היא תיקיית הפרויקט. היישום קורא document.docx מתיקייה זו ושומר document_Redacted.docx לצד הקובץ המקורי.

6. בדיקת המסמך המוחק

פתח את document_Redacted.docx. הביטוי essential tool אמור להיות מוחלף ב‑[redacted]. הקובץ המקורי document.docx נשאר ללא שינוי.

ניתן להשתמש באותו פרויקט למחיקת ביטויים אחרים על‑ידי שינוי הביטוי הרגולרי וטקסט ההחלפה.

רישוי

ללא רישיון, GroupDocs.Redaction for .NET 26.10 פועל במצב הערכה. תהליך יחיד יכול לפתוח עד 25 מסמכים. ניסיון לפתוח מסמך נוסף יגרום ל‑TrialLimitationsException. חותמות ניסיון מתווספות לחלק העליון של כל עמוד במסמכים השמורים.

רישיון זמני זמין ב‑דף הרישיון הזמני של GroupDocs. רישיון קבוע זמין ב‑דף הרכישה של GroupDocs.

למידע נוסף