.NET 애플리케이션이 Windows에서 실행되면 GroupDocs.Redaction for .NET의 Windows 전용 빌드를 사용할 수 있습니다. 이 자습서에서는 net10.0-windows를 대상으로 하는 .NET 10 콘솔 애플리케이션을 만들고, 정규식으로 Word 문서의 구문을 마스킹한 뒤 마스킹된 문서를 저장하는 방법을 보여 줍니다.
완성된 프로젝트는 GitHub에서 받을 수 있습니다.
1. Windows용 .NET 콘솔 프로젝트 만들기
Visual Studio 또는 .NET CLI로 프로젝트를 만들 수 있습니다. 프로젝트의 대상 프레임워크는 net10.0-windows여야 합니다. 이 대상 프레임워크에서는 NuGet이 Windows 전용 GroupDocs.Redaction.Net100.Windows 어셈블리를 복원합니다. 이 빌드에는 Windows 전용 종속성이 포함됩니다.
-windows 접미사 없는 net10.0을 대상으로 하는 프로젝트는 크로스 플랫폼 빌드를 사용합니다.
Visual Studio 사용
새 콘솔 앱을 만들고 대상 프레임워크로 .NET 10.0을 선택합니다. 프로젝트를 만든 뒤 프로젝트 파일을 열고 대상 프레임워크를 다음과 같이 설정합니다.
<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 설치
Visual Studio 또는 .NET CLI로 GroupDocs.Redaction for .NET 26.10.0을 추가합니다.
Visual Studio 사용
- 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다.
- NuGet 패키지 관리를 선택합니다.
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 속성은 SetLicense가 유효한 라이선스를 로드할 때까지 false를 반환합니다. 라이선스 모드로 실행하려면 SetLicense 호출의 주석을 해제하고 라이선스 파일 경로를 지정합니다.
정규식 \s+essential tool은 하나 이상의 공백 뒤에 오는 구문 essential tool과 일치합니다. 검색은 대소문자를 구분하지 않으므로 Essential Tool도 일치합니다. 구문 앞의 공백을 포함한 각 일치는 [redacted]로 바뀝니다.
RasterizeToPDF 속성은 false이므로 문서는 Word 형식을 유지합니다. AddSuffix 속성은 true이므로 출력 파일은 Redacted 접미사와 함께 저장됩니다.
document_Redacted.docx
Save 메서드는 저장된 파일의 경로를 반환합니다.
5. 애플리케이션 실행
Visual Studio 사용
WindowsSpecificRedaction.slnx또는 프로젝트 파일을 엽니다.- 디버그하려면 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 구매 페이지에서 받을 수 있습니다.