원본 형식으로 GroupDocs.Redaction .NET을 사용하여 편집된 문서 저장

편집된 민감한 데이터를 보호하는 것은 일반적인 규정 준수 요구 사항이지만 원본 파일의 모양과 느낌을 잃고 싶지는 않습니다. 이 튜토리얼에서는 GroupDocs.Redaction for .NET을 사용하여 원본 형식을 유지하면서 편집된 문서를 저장하는 방법을 보여줍니다. PDF, Word 파일 등에서 작동하는 즉시 실행 가능한 솔루션을 얻을 수 있습니다.

빠른 답변

  • 편집된 문서를 저장하는 가장 빠른 방법은 무엇인가요? Redactor로 파일을 로드하고 ExactPhraseRedaction을 적용한 다음 원본 파일 유형을 유지하는 SaveOptions와 함께 Save를 호출합니다.
  • 지원되는 형식은 무엇인가요? PDF, DOCX, PPTX 및 이미지 유형을 포함한 30개 이상의 형식이 지원됩니다.
  • 체험판 사용에 라이선스가 필요합니까? 예 – GroupDocs 포털에서 임시 라이선스를 얻으세요.
  • 저장된 파일에 사용자 지정 접미사를 추가할 수 있나요? 물론입니다 – SaveOptions.Suffix를 원하는 문자열(예: 날짜)로 설정하면 됩니다.
  • 대용량 파일 처리 시 메모리 효율이 좋은가요? 예 – GroupDocs.Redaction은 데이터를 스트리밍하고 전체 파일을 메모리에 로드하지 않습니다.

“편집된 문서 저장”이란 무엇인가요?

편집된 문서를 저장한다는 것은 수정된 파일을 원본 레이아웃, 파일 유형 및 메타데이터를 유지하면서 저장소에 다시 쓰는 것을 의미합니다. GroupDocs.Redaction은 이를 단일 호출로 처리하여 수동 형식 변환이 필요 없게 합니다. 이 과정은 폰트, 이미지 및 문서 속성 같은 임베디드 리소스를 유지하므로, 제거된 콘텐츠를 제외하고 출력이 원본과 동일하게 보입니다.

.NET용 GroupDocs.Redaction을 사용하는 이유

GroupDocs.Redaction은 30개 이상의 입력 및 출력 형식을 지원하며 전체 문서를 메모리에 로드하지 않고 500 MB까지 파일을 처리할 수 있어, 단순 파일 재작성 방식에 비해 20‑30 % 성능 향상을 제공합니다. API는 완전 관리형이며 외부 소프트웨어가 필요 없고 GDPR, HIPAA 및 기타 규정을 준수합니다.

전제 조건

  • GroupDocs.Redaction for .NET – 핵심 라이브러리(최신 안정 버전).
  • .NET 6+ 또는 **.NET Framework 4.7.2+**가 개발 머신에 설치되어 있어야 합니다.
  • 기본 C# 지식 및 Visual Studio 또는 선호하는 IDE에 대한 친숙함.

필수 라이브러리 및 종속성

  • GroupDocs.Redaction for .NET: 편집 적용에 필수.

환경 설정 요구 사항

프로젝트가 지원되는 .NET 런타임을 대상으로 하는지 확인하십시오. 정확한 버전 매트릭스는 공식 GroupDocs 문서를 참조하세요.

지식 전제 조건

C# 구문, 파일 I/O 및 예외 처리에 대한 이해.

GroupDocs.Redaction for .NET 설정

설치 안내

Using .NET CLI:

dotnet add package GroupDocs.Redaction

Using Package Manager Console:

Install-Package GroupDocs.Redaction

Via NuGet Package Manager UI:

  • Visual Studio에서 NuGet 패키지 관리자를 엽니다.
  • **“GroupDocs.Redaction”**을 검색하고 최신 버전을 설치합니다.

라이선스 획득

기능을 테스트하려면 무료 체험으로 시작하십시오. 필요하면 GroupDocs 웹사이트에서 임시 라이선스를 요청하세요. 장기 사용을 위해서는 사이트에서 라이선스를 구매하는 것을 고려하십시오.

설치 및 라이선스가 적용되면 코드 파일에서 GroupDocs.Redaction 네임스페이스를 참조합니다:

using GroupDocs.Redaction;

구현 가이드

Redactor 생성 및 구성

Redactor 클래스는 문서를 로드하고 편집 작업을 적용하는 핵심 구성 요소입니다.

단계 1: Redactor 초기화

Redactor 클래스의 인스턴스를 문서 파일 경로와 함께 생성합니다:

string sourceFile = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual path.
using (Redactor redactor = new Redactor(sourceFile))
{
    ...
}

단계 2: Exact Phrase Redaction 적용

ExactPhraseRedaction은 정확한 문자열을 검색하고 검은 사각형 또는 사용자 지정 텍스트로 교체하는 내장 편집 유형입니다.

// This replaces all instances of "John Doe" with "[personal]".
redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]"));

편집된 문서 저장

접미사를 추가하면서 원본 형식을 유지하는 것은 SaveOptions로 처리됩니다.

단계 3: Save Options 구성

SaveOptions를 사용하면 원본 파일 유형을 유지하고, 접미사를 지정하며, 메모리 사용량을 제어할 수 있습니다.

var saveOptions = new SaveOptions() 
{
    AddSuffix = true,                  // Adds a suffix like "2023-10-12" to indicate modification.
    RasterizeToPDF = false,           // Ensures the document remains in its original format.
    RedactedFileSuffix = DateTime.Now.ToShortDateString()
};

단계 4: 저장 및 출력

구성된 옵션으로 Save 메서드를 호출하여 편집된 파일을 디스크에 씁니다:

var outputFile = redactor.Save(saveOptions);
Console.WriteLine($"\nSource document was redacted successfully.\nFile saved to {outputFile}.\n");

원본 형식을 유지하면서 편집된 문서를 저장하는 방법은?

new Redactor("source.pdf")로 소스 파일을 로드하고 하나 이상의 편집을 적용한 다음, 원본 형식을 유지하고 접미사(예: “_redacted”)를 추가하도록 SaveOptions를 구성하고 redactor.Save("output.pdf", saveOptions)를 호출합니다. 이 단일 단계 워크플로우는 출력이 입력 파일과 동일한 레이아웃, 폰트 및 메타데이터를 유지하면서 편집된 콘텐츠를 영구적으로 제거함을 보장합니다.

일반적인 문제 및 해결책

  • 문서가 로드되지 않음 – 파일 경로를 확인하고 프로세스에 읽기 권한이 있는지 확인하십시오.
  • 편집 실패 – 정확한 구문 철자와 대소문자를 다시 확인하십시오; 필요하면 IgnoreCase = true를 사용하세요.
  • 출력 파일 손상 – SaveOptions가 소스 형식과 일치하는지 확인하십시오; 형식이 일치하지 않으면 결과가 손상될 수 있습니다.

실용적인 적용 사례

GroupDocs.Redaction .NET은 규제 산업에서 뛰어난 성능을 발휘합니다:

  1. 법률 문서 관리 – 계약을 공유하기 전에 클라이언트 이름, SSN 또는 사건 번호를 자동으로 제거합니다.
  2. 헬스케어 데이터 프라이버시 – 의료 기록에서 환자 식별자를 마스킹하여 HIPAA 준수를 유지합니다.
  3. 재무 보고 – 분기 보고서 배포 전에 기밀 계좌 번호를 제거합니다.

성능 고려 사항

대용량 파일(수백 메가바이트)을 처리할 때는 다음 모범 사례를 따르세요:

  • CPU 사이클을 줄이기 위해 간결한 검색 패턴을 사용하십시오.
  • Redactor 인스턴스를 즉시 해제(using 블록)하여 관리되지 않는 리소스를 해제합니다.
  • 메모리 사용량을 낮추기 위해 SaveOptions.Streaming = true를 활용하십시오.

결론

이제 GroupDocs.Redaction for .NET을 사용하여 원본 형식으로 편집된 문서를 저장하는 완전하고 프로덕션 준비된 방법을 갖추었습니다. 위 단계들을 따르면 보안 편집을 모든 .NET 워크플로에 삽입하여 문서 충실성을 손상시키지 않고 규정을 준수할 수 있습니다.

배치 편집, 사용자 지정 편집 형태, 클라우드 스토리지와의 통합 등 고급 기능을 탐색하여 솔루션을 더욱 확장해 보세요.

자주 묻는 질문

Q: GroupDocs.Redaction이 처리할 수 있는 파일 유형은 무엇인가요?
A: PDF, DOCX, PPTX, XLSX 및 PNG, JPEG와 같은 일반 이미지 유형을 포함한 30개 이상의 형식을 지원합니다.

Q: 저장하기 전에 편집을 미리 볼 수 있나요?
A: 예 – Redactor 클래스는 UI에 렌더링할 수 있는 컬렉션을 반환하는 GetRedactions() 메서드를 제공합니다.

Q: 비밀번호로 보호된 문서를 편집할 수 있나요?
A: 물론입니다. Redactor 인스턴스를 생성할 때 비밀번호를 제공하여 파일을 잠금 해제하십시오.

Q: 라이브러리가 .NET Core 및 .NET 5/6을 지원하나요?
A: 예 – NuGet 패키지는 .NET Framework 4.7.2+, .NET Core 3.1+, .NET 5/6+와 호환됩니다.

Q: 프로덕션 라이선스를 어떻게 얻나요?
A: GroupDocs 웹사이트를 통해 라이선스를 구매하십시오; 평가용 임시 체험 라이선스도 제공됩니다.

리소스

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

관련 튜토리얼