GroupDocs.Redaction for .NET로 문서 로드하는 방법

이 가이드에서는 로컬 디스크, 메모리 스트림, 그리고 비밀번호로 보호된 파일 등 다양한 소스에서 GroupDocs.Redaction for .NET으로 문서를 로드하는 방법을 알아봅니다. 레드액션 서비스, 자동화된 컴플라이언스 파이프라인, 혹은 간단한 데스크톱 유틸리티를 구축하든, 이러한 로드 기술을 숙달하면 어떤 문서든 안전하게 레드액션할 수 있도록 빠르고 안정적으로 준비할 수 있습니다.

빠른 답변

  • 첫 번째 단계는 무엇인가요? GroupDocs.Redaction NuGet 패키지를 설치하고 using GroupDocs.Redaction; 네임스페이스를 추가합니다.
  • 스트림에서 PDF를 로드할 수 있나요? 예—PDF 바이트를 포함하는 MemoryStream을 RedactionEngine 생성자에 전달하면 됩니다.
  • 비밀번호로 보호된 파일을 어떻게 열나요? RedactionEngine을 생성할 때 두 번째 인수로 비밀번호를 제공합니다.
  • 파일 크기 제한이 있나요? GroupDocs.Redaction은 전체 파일을 메모리에 로드하지 않고도 최대 2 GB까지 처리합니다.
  • 개발에 라이선스가 필요합니까? 테스트용 임시 라이선스가 작동하며, 프로덕션 배포에는 정식 라이선스가 필요합니다.

문서를 로드하는 방법은?

RedactionEngine은 레드액션을 위해 문서를 로드하고 준비하는 핵심 클래스입니다. 파일 경로(또는 스트림)와 필요에 따라 비밀번호를 전달하여 RedactionEngine 인스턴스를 생성하면 문서를 로드할 수 있습니다. 이 한 줄 호출은 파일을 읽고, 형식을 검증하며, 레드액션 준비가 된 내부 문서 모델을 구축합니다. 예를 들어, 디스크에서 PDF를 로드하는 것은 new RedactionEngine("sample.pdf")와 같이 간단합니다. 비밀번호가 필요할 경우 new RedactionEngine("secret.pdf", "MyPassword")를 사용합니다. 스트림에서 로드하는 경우에도 MemoryStream 인수를 사용해 동일한 패턴을 따릅니다.

GroupDocs.Redaction이란?

GroupDocs.Redaction은 개발자가 PDF, DOCX, PPTX 및 30개 이상의 다른 파일 형식에서 민감한 콘텐츠를 찾아 영구적으로 제거할 수 있게 해주는 .NET 라이브러리입니다. 픽셀 단위의 정확한 레드액션, OCR 지원, 배치 처리를 제공하여 다양한 문서 유형에 대해 신뢰할 수 있고 안전한 데이터 보호가 필요한 컴플라이언스 중심 애플리케이션에 이상적입니다.

문서 로드에 GroupDocs.Redaction을 사용하는 이유는?

GroupDocs.Redaction은 최대 2 GB까지 대용량 파일을 처리할 수 있는 고성능, 저메모리 스트리밍 엔진을 제공하며, 비밀번호로 보호된 문서도 바로 지원합니다. 속도, 유연성, 보안성을 결합한 이 솔루션은 레드액션 규칙을 적용하기 전에 문서를 빠르고 안전하게 로드해야 하는 개발자들에게 선호되는 선택입니다.

  • 다양한 형식 지원: PDF, Word, Excel, PowerPoint 및 이미지 파일을 포함한 30개 이상의 문서 유형을 처리합니다.
  • 고성능 스트리밍: 저메모리 스트리밍 엔진을 사용해 2 GB까지 파일을 처리하므로 전체 파일을 로드할 필요가 없습니다.
  • 비밀번호 처리: 단일 메서드 오버로드로 비밀번호로 보호된 PDF 및 Office 파일을 손쉽게 열어 코드 복잡성을 줄입니다.
  • 스레드 안전 API: 레이스 컨디션 없이 다중 스레드 서비스에서 여러 문서를 동시에 로드할 수 있습니다.

전제 조건

  • .NET 6.0 이상 (이 라이브러리는 .NET Core 3.1 및 .NET Framework 4.6.1+도 지원합니다).
  • 유효한 GroupDocs.Redaction 라이선스 (테스트용 임시 라이선스).
  • 레드액션하려는 문서 파일에 대한 접근 권한 (로컬 경로, 바이트 배열 또는 스트림).

다양한 소스에서 문서 로드하기

로컬 디스크에서 로드하기

엔진을 생성할 때 파일의 절대 경로나 상대 경로를 제공하십시오. 라이브러리는 자동으로 형식을 감지하고 레드액션을 위해 준비합니다.

메모리 스트림에서 로드하기

파일을 byte[]로 읽은 뒤 MemoryStream으로 감싸서 생성자에 전달합니다. 이 방법은 파일을 업로드 형태로 받는 웹 API에 최적입니다.

비밀번호로 보호된 파일 로드하기

문서가 암호화된 경우 두 번째 인수로 비밀번호를 제공하십시오. 엔진은 파일을 실시간으로 복호화하고 추가 단계 없이 레드액션에 사용할 수 있도록 콘텐츠를 제공합니다.

일반적인 문제와 해결책

  • 오류: “File format not supported.”
    파일 확장자가 지원되는 형식과 일치하는지, 파일이 손상되지 않았는지 확인하십시오. GroupDocs.Redaction은 30개 이상의 형식을 지원하므로 전체 목록은 API 레퍼런스를 참고하세요.
  • 비밀번호 관련 예외.
    비밀번호 문자열이 정확한지, 파일이 실제로 비밀번호를 요구하는지 확인하십시오. 보호된 파일에 빈 문자열을 전달하면 인증 오류가 발생합니다.
  • 매우 큰 파일에서 메모리 부족.
    파일 경로로 로드하는 대신 스트리밍 오버로드(RedactionEngine(Stream))를 사용하십시오. 이렇게 하면 수백 페이지 PDF에서도 메모리 사용량을 낮게 유지할 수 있습니다.

자주 묻는 질문

Q: DOCX 파일을 PDF와 같은 방식으로 로드할 수 있나요?
A: 예—파일 경로나 스트림을 전달하면 GroupDocs.Redaction이 자동으로 DOCX 형식을 감지하므로 추가 코드가 필요 없습니다.

Q: 라이브러리가 Azure Blob Storage에서 파일 로드를 지원하나요?
A: 물론입니다. Blob을 바이트 배열이나 스트림으로 가져와 RedactionEngine 생성자에 전달하면 됩니다.

Q: 잘못된 비밀번호를 제공하면 어떻게 되나요?
A: 생성자가 PasswordIncorrectException을 발생시킵니다. 이 예외를 잡아 사용자가 올바른 비밀번호를 입력하도록 안내하십시오.

Q: 여러 문서를 동시에 로드할 수 있나요?
A: 예—각 RedactionEngine 인스턴스는 독립적이며 스레드 안전하므로 백그라운드 서비스에서 병렬 처리할 수 있습니다.

Q: RedactionEngine을 수동으로 해제해야 하나요?
A: 엔진은 IDisposable을 구현합니다. Dispose()를 호출하거나 using 블록으로 감싸 파일 핸들을 즉시 해제하십시오.

추가 리소스

마지막 업데이트: 2026-06-11
테스트 환경: GroupDocs.Redaction 5.5 for .NET
작성자: GroupDocs

관련 튜토리얼