GroupDocs.Redaction .NET을 사용하여 프로그래밍 방식으로 레드액트 PDF 만들기

오늘날 디지털 시대에 create redacted PDF programmatically는 개인 또는 기밀 데이터를 처리하는 모든 애플리케이션에 필수적인 기능입니다. GDPR, HIPAA 또는 내부 보안 정책을 준수해야 하든, PDF를 공유하기 전에 민감한 정보를 레드액트하면 개인 정보 보호와 법적 위험 감소에 도움이 됩니다. 이 튜토리얼에서는 GroupDocs.Redaction for .NET을 사용하여 문서를 찾아서 마스크하고 최종적으로 보안 PDF로 저장하는 방법을 보여줍니다. 다음을 배우게 됩니다:

  • Word, Excel, PowerPoint 및 기타 지원 형식에서 민감한 정보를 레드액트합니다
  • 레드액트된 콘텐츠를 이미지로 변환하고 PDF에 삽입합니다
  • 대용량 파일에 대한 성능을 최적화하고 기존 .NET 프로젝트에 솔루션을 통합합니다

시작하기 전에 필요한 모든 것이 준비되었는지 확인해 보겠습니다.

빠른 답변

  • “create redacted PDF programmatically”가 의미하는 바는 무엇인가요? 코드를 사용하여 기밀 데이터를 자동으로 찾아 마스크하고, 결과를 PDF로 저장한다는 의미입니다.
  • 레드액트를 처리하는 라이브러리는 무엇인가요? GroupDocs.Redaction for .NET.
  • 개발에 라이선스가 필요합니까? 평가용으로는 무료 체험판을 사용할 수 있으며, 프로덕션에서는 영구 라이선스가 필요합니다.
  • 지원되는 파일 형식은 무엇인가요? DOCX, XLSX, PPTX, PDF 및 이미지 형식을 포함해 30가지 이상의 형식을 지원합니다.
  • 대용량 파일을 효율적으로 처리할 수 있나요? 예—비동기 메서드와 청크 처리 방식을 사용하여 최대 2 GB 파일을 처리할 수 있습니다.

프로그래밍 방식으로 레드액트 PDF를 만드는 것이란 무엇인가요?

프로그래밍 방식으로 레드액트 PDF를 만드는 것은 코드를 사용하여—보통 GroupDocs.Redaction과 같은 API를 통해—소스 파일 내의 기밀 텍스트, 이미지 또는 메타데이터를 찾아 정의된 규칙에 따라 해당 내용을 교체하거나 제거하고, 원래의 민감한 정보를 포함하지 않는 새로운 PDF를 생성하는 것을 의미합니다. 이 자동화된 접근 방식은 대량 문서 세트 전반에 걸쳐 일관성과 규정 준수를 보장합니다.

왜 .NET용 GroupDocs.Redaction을 사용하나요?

GroupDocs.Redaction은 30개 이상의 입력 및 출력 형식을 지원하며 전체 파일을 메모리에 로드하지 않고 2 GB까지 문서를 처리할 수 있어, 단순한 방법에 비해 RAM 사용량을 30 % 감소시킵니다. 또한 라이브러리는 내장 OCR 레드액트를 제공하여 스캔된 이미지조차도 검색 가능하고 제거할 수 있도록 합니다.

전제 조건

시작하기 전에 다음이 준비되어 있는지 확인하십시오:

  • .NET 6.0 이상이 개발 머신에 설치되어 있어야 합니다.
  • Visual Studio 2022(또는 .NET 호환 IDE).
  • 레드액트하려는 문서가 들어 있는 폴더에 대한 접근 권한.
  • 기본 C# 지식 및 NuGet 패키지 관리에 대한 이해.

필요한 라이브러리 및 종속성

GroupDocs.Redaction for .NET와 호환되는 최신 .NET 런타임이 설치되어 있는지 확인하십시오. 자세한 버전 정보는 GroupDocs documentation에서 확인할 수 있습니다.

환경 설정 요구 사항

  • Visual Studio 또는 .NET 개발을 지원하는 다른 IDE.
  • 레드액트된 PDF가 저장될 출력 디렉터리에 대한 쓰기 권한.

지식 전제 조건

다음에 익숙해야 합니다:

  • C# 파일 I/O (System.IO).
  • NuGet 패키지 설치 및 참조.

GroupDocs.Redaction for .NET 설정

프로젝트에 라이브러리를 추가하려면 다음 방법 중 하나를 사용하십시오.

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI
**“GroupDocs.Redaction”**을 검색하고 최신 안정 버전을 설치합니다.

라이선스 획득

모든 기능을 사용할 수 있는 무료 체험판으로 시작할 수 있습니다. 프로덕션 사용을 위해서는 GroupDocs에서 임시 또는 영구 라이선스를 획득하십시오.

기본 초기화

using GroupDocs.Redaction;

이 코드 라인은 GroupDocs와의 여정을 시작합니다.

프로그래밍 방식으로 레드액트 PDF를 만드는 방법은?

프로그래밍 방식으로 레드액트 PDF를 만들려면 먼저 소스 문서를 Redactor 인스턴스로 로드한 다음, 제거하거나 교체할 텍스트 또는 패턴을 지정하는 하나 이상의 Redaction 객체를 정의하고 적용하며, 마지막으로 PdfSaveOptions와 함께 Save 메서드를 호출하여 보안 PDF 파일을 생성합니다. 다음 코드는 각 단계를 보여줍니다.

1단계: Redactor 초기화

Redactor는 문서를 로드, 처리 및 저장하면서 문서 무결성을 유지하는 핵심 클래스입니다.

using (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY\SampleDocument.docx"))
{
    // Further operations will go here.
}

왜 Redactor를 사용하나요?
Redactor 클래스는 문서를 구조화된 방식으로 처리하도록 제공하여 효율적인 메모리 관리와 형식 전반에 걸친 일관된 레드액트 결과를 보장합니다.

2단계: 정확한 구문 레드액트 적용

Redaction 객체는 숨길 텍스트와 교체 방법을 정의합니다.

redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]"));

매개변수 및 메서드 이해

  • "John Doe" – 찾을 정확한 구문입니다.
  • ReplacementOptions – 자리 표시자(예: "[personal]")와 시각적 스타일을 지정합니다.

3단계: PDF로 저장

PdfSaveOptions는 이미지 품질 및 페이지 범위를 포함한 최종 PDF 출력을 제어합니다.

redactor.Save(new PdfSaveOptions());

핵심 구성 옵션
PageCount, ImageQuality, CompressImages를 설정하여 파일 크기와 시각적 품질 사이의 균형을 맞출 수 있습니다.

일반적인 문제 및 해결책

  • 파일 경로 오류 – 입력 및 출력 경로가 절대 경로나 실행 디렉터리에 대해 올바르게 상대적인지 확인하십시오.
  • 지원되지 않는 형식 – 공식 문서의 형식 목록을 확인하십시오; 오래된 Office 형식은 먼저 변환이 필요할 수 있습니다.
  • 대용량 파일에서 메모리 급증 – 비동기 API(Redactor.RedactAsync)를 사용하고 문서를 청크 단위로 처리하십시오.

실제 적용 사례

  1. 법률 문서 처리 – 계약서를 외부 변호사와 공유하기 전에 개인 식별자를 자동으로 마스크합니다.
  2. 헬스케어 데이터 관리 – 임상 내용을 유지하면서 의료 보고서에서 환자 이름 및 ID를 제거합니다.
  3. 재무 보고 – 분기 보고서에서 계좌 번호 및 기밀 수치를 숨깁니다.

성능 고려 사항

  • 청크 처리는 500페이지 이상의 파일에 대해 RAM 사용량을 최대 **40 %**까지 줄입니다.
  • 비동기 메서드는 데스크톱 앱의 UI 응답성을 개선하고 웹 서비스의 처리량을 증가시킵니다.
  • 업데이트 유지 – 새로운 릴리스는 형식 지원 및 성능 패치를 추가하므로 최신 버전으로 테스트하십시오.

자주 묻는 질문

Q: 2 GB보다 큰 문서는 어떻게 처리하나요?
A: 소스 파일을 논리적 섹션(예: 챕터별)으로 분할하고 각 섹션을 개별적으로 레드액트한 뒤, 결과 PDF를 병합합니다.

Q: 레드액트 자리 표시자 스타일을 사용자 정의할 수 있나요?
A: 예—ReplacementOptions를 사용하면 자리 표시자 텍스트 또는 이미지의 글꼴, 색상 및 불투명도를 정의할 수 있습니다.

Q: GroupDocs.Redaction이 스캔된 PDF에 대한 OCR을 지원하나요?
A: 물론입니다. Redactor를 생성할 때 OcrOptions를 활성화하면 이미지 내 텍스트를 감지하고 레드액트할 수 있습니다.

Q: 배치 처리가 가능한가요?
A: 파일 경로 컬렉션을 반복하고 동일한 레드액트 로직을 병렬 작업으로 호출하여 수십 개의 파일을 동시에 처리할 수 있습니다.

Q: 오류가 발생하면 어디에서 도움을 받을 수 있나요?
A: 커뮤니티 지원 및 제품 팀의 공식 지원을 위해 GroupDocs Free Support Forum을 방문하십시오.

리소스


마지막 업데이트: 2026-10-16
테스트 환경: GroupDocs.Redaction 5.0 for .NET
작성자: GroupDocs

관련 튜토리얼