Bir .NET uygulaması Windows üzerinde çalıştığında, GroupDocs.Redaction for .NET ürününün Windows’a özgü derlemesini kullanabilir. Bu öğretici, net10.0-windows hedefleyen bir .NET 10 konsol uygulamasının nasıl oluşturulacağını, bir Word belgesindeki ifadenin düzenli ifadeyle nasıl redakte edileceğini ve redakte edilmiş belgenin nasıl kaydedileceğini gösterir.

Projenin çalışan tam sürümü GitHub üzerinde bulunmaktadır.

1. Windows için bir .NET konsol projesi oluşturun

Projeyi Visual Studio veya .NET CLI ile oluşturabilirsiniz. Proje net10.0-windows hedeflemelidir. NuGet, bu hedef çerçeve için Windows’a özgü GroupDocs.Redaction.Net100.Windows derlemesini geri yükler. Bu derleme Windows’a özgü bağımlılıklar içerir.

-windows soneki olmadan net10.0 hedefleyen projeler çapraz platform derlemesini kullanır.

Visual Studio kullanma

Yeni bir Konsol Uygulaması oluşturun ve hedef çerçeve olarak .NET 10.0 seçin. Projeyi oluşturduktan sonra proje dosyasını açın ve hedef çerçeveyi şöyle ayarlayın:

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

.NET CLI kullanma

Bir .NET 10 konsol uygulaması oluşturun ve proje dizinini açın:

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

Ardından WindowsSpecificRedaction.csproj içinde aynı hedef çerçeveyi ayarlayın:

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

Bu adımdaki proje dosyaları şunlardır:

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

2. GroupDocs.Redaction 26.10 sürümünü yükleyin

Visual Studio veya .NET CLI ile GroupDocs.Redaction for .NET 26.10.0 ekleyin.

Visual Studio kullanma

  1. Solution Explorer içinde projeye sağ tıklayın.
  2. Manage NuGet Packages seçeneğini seçin.
  3. GroupDocs.Redaction araması yapın ve 26.10.0 sürümünü yükleyin.

.NET CLI kullanma

Proje dizininden şu komutu çalıştırın:

dotnet add package GroupDocs.Redaction --version 26.10.0

Paket, belgeleri yüklemek ve kaydetmek için Redactor sınıfını, düzenli ifade eşleşmelerini redakte etmek için RegexRedaction sınıfını ve geçerli bir lisansın uygulanıp uygulanmadığını denetlemek için License.IsLicensed özelliğini sağlar.

3. Word dosyasını ekleyin

Word belgesini proje dizinine yerleştirin ve şu adı verin:

document.docx

Proje dosyasında, belgenin derleme çıktı dizinine kopyalanmasını yapılandırın:

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

Örnek belge essential tool ifadesini içerir. Uygulama eşleşen ifadeyi değiştirir ve document_Redacted.docx oluşturur. Özgün document.docx değişmeden kalır.

4. Redaksiyon kodunu ekleyin

Program.cs dosyasını açın ve içeriğini aşağıdaki kodla değiştirin:

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 özelliği, SetLicense geçerli bir lisans yükleyene kadar false döndürür. Uygulamayı lisanslı modda çalıştırmak için SetLicense çağrısının açıklamasını kaldırın ve lisans dosyanızın yolunu belirtin.

\s+essential tool düzenli ifadesi, bir veya daha fazla boşluk karakterinin ardından gelen essential tool ifadesiyle eşleşir. Arama büyük/küçük harfe duyarsızdır, bu nedenle Essential Tool da eşleşir. İfadenin önündeki boşluk dahil her eşleşme [redacted] ile değiştirilir.

RasterizeToPDF özelliği false olduğu için belge Word biçimini korur. AddSuffix özelliği true olduğu için çıktı dosyası Redacted sonekiyle kaydedilir:

document_Redacted.docx

Save yöntemi, kaydedilen dosyanın yolunu döndürür.

5. Uygulamayı çalıştırın

Visual Studio kullanma

  1. WindowsSpecificRedaction.slnx dosyasını veya proje dosyasını açın.
  2. Hata ayıklamak için F5, hata ayıklamadan çalıştırmak için Ctrl+F5 tuşuna basın.

Uygulama Visual Studio içinden çalıştırıldığında çalışma dizini genellikle derleme çıktı dizinidir. Redakte edilmiş dosya şuraya kaydedilir:

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

.NET CLI kullanma

Proje dizininden şu komutu çalıştırın:

dotnet run

dotnet run kullanıldığında çalışma dizini proje dizinidir. Uygulama document.docx dosyasını bu dizinden okur ve document_Redacted.docx dosyasını yanına kaydeder.

6. Redakte edilmiş belgeyi denetleyin

document_Redacted.docx dosyasını açın. essential tool ifadesi [redacted] ile değiştirilmiş olmalıdır. Özgün document.docx değişmeden kalır.

Düzenli ifadeyi ve değiştirme metnini düzenleyerek aynı projeyle başka ifadeleri de redakte edebilirsiniz.

Lisanslama

Lisans olmadan GroupDocs.Redaction for .NET 26.10 değerlendirme modunda çalışır. Tek bir işlem en fazla 25 belge açabilir. Başka bir belge açmaya çalışmak TrialLimitationsException oluşturur. Kaydedilen belgelerde her sayfanın üstüne deneme rozetleri eklenir.

Geçici lisans GroupDocs geçici lisans sayfasında bulunur. Kalıcı lisans GroupDocs satın alma sayfasında bulunur.

Daha fazla bilgi