GroupDocs.Redaction .NET으로 메타데이터 검색하는 방법

오늘날 디지털 시대에 파일에서 메타데이터를 검색하는 방법은 모든 문서 중심 애플리케이션에 필수적인 단계입니다. 규정 준수 감사를 위해 파일 메타데이터를 읽어야 하든, 인덱싱을 위해 문서 속성을 추출하든, UI에 문서 크기를 표시하든, GroupDocs.Redaction .NET은 몇 줄의 C# 코드만으로 이를 수행할 수 있는 간결한 API를 제공합니다. 이 튜토리얼은 환경 설정부터 검색된 정보를 표시하는 단계까지 전체 과정을 안내하므로 바로 문서 메타데이터 추출을 시작할 수 있습니다.

빠른 답변

  • 메타데이터를 가져오는 기본 메서드는? Redactor 인스턴스에서 Redactor.GetDocumentInfo()를 호출합니다.
  • 지원되는 형식은? PDF, DOCX, XLSX, PPTX 및 이미지 유형을 포함해 50개 이상의 입력 및 출력 형식이 지원됩니다.
  • 개발에 라이선스가 필요합니까? 테스트용 무료 체험 라이선스로 충분하며, 프로덕션에서는 정식 라이선스가 필요합니다.
  • 대용량 파일을 처리할 수 있나요? 예—GroupDocs.Redaction은 전체 파일을 메모리에 로드하지 않고도 수백 페이지 문서를 처리합니다.
  • 비동기 지원이 있나요? API를 비동기 패턴으로 래핑하여 UI 스레드가 응답성을 유지하도록 할 수 있습니다.

GroupDocs.Redaction에서 메타데이터 검색이란?

메타데이터 검색은 라이브러리 API를 통해 문서의 내장 속성(파일 유형, 페이지 수, 크기 등)에 접근하는 과정입니다. 이러한 속성을 추출하면 개발자는 문서 특성을 프로그래밍적으로 평가하고, 인덱싱을 지원하며, 규정 준수 규칙을 적용하고, 이후 처리 단계에 대한 의사 결정을 내릴 수 있습니다.

문서 메타데이터를 검색하는 방법

Redactor 클래스는 GroupDocs.Redaction에서 문서를 로드하고 검사하는 주요 인터페이스입니다.
GetDocumentInfo() 메서드는 문서 메타데이터를 포함하는 DocumentInfo 객체를 반환합니다.

new Redactor("path/to/file") 로 파일을 로드하고 GetDocumentInfo()를 호출하면 타입, 페이지 수, 크기 및 기타 속성을 포함한 DocumentInfo 객체가 반환됩니다. 이 두 단계 접근 방식은 모든 지원 형식에 적용되며 추가 설정이 필요 없습니다. 이후 FileType, PageCount, FileSize와 같은 필드를 읽어 정보를 표시하거나 로그에 기록할 수 있습니다.

사전 요구 사항

  • GroupDocs.Redaction .NET 버전 21.6 이상.
  • .NET Framework 4.7.2 +, .NET Core 3.1 +, 또는 .NET 5/6+.
  • 기본 C# 지식 및 개발 IDE(Visual Studio, Rider 등).

GroupDocs.Redaction for .NET 설정

GroupDocs.Redaction 시작은 간단합니다. 다음 중 하나의 방법으로 패키지를 설치하세요:

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

또는 NuGet Package Manager UI를 사용하세요: “GroupDocs.Redaction”을 검색하고 Install를 클릭하면 됩니다.

라이선스 획득

GroupDocs.Redaction을 체험하려면 무료 체험 라이선스를 받을 수 있습니다. 지속적인 개발 또는 프로덕션 사용을 위해서는 정식 라이선스를 구매하거나 공식 사이트에서 임시 라이선스를 요청하세요.

설치가 완료되면 다음과 같이 라이브러리를 초기화합니다:

using GroupDocs.Redaction;

구현 가이드

문서 정보 가져오기 기능

이 기능은 GroupDocs.Redaction .NET을 사용해 문서에서 핵심 메타데이터를 추출하는 방법에 초점을 맞춥니다. 다음 단계를 따르세요:

1단계: 문서 경로 준비

대상 파일의 절대 경로나 상대 경로를 정의합니다:

string sourceFile = "YOUR_DOCUMENT_DIRECTORY\\SampleDocx.docx";

YOUR_DOCUMENT_DIRECTORY를 문서가 들어 있는 폴더 경로로 교체하세요.

2단계: Redactor 인스턴스 초기화

메타데이터 메서드에 접근할 수 있는 Redactor 객체를 생성합니다:

using (Redactor redactor = new Redactor(sourceFile))
{
    // Further operations will be performed here
}

3단계: 문서 정보 검색

Redactor 인스턴스에서 GetDocumentInfo()를 호출해 모든 사용 가능한 속성을 가져옵니다:

IDocumentInfo info = redactor.GetDocumentInfo();

반환된 객체에는 파일 유형, 페이지 수, 파일 크기 등이 포함됩니다.

4단계: 문서 상세 정보 표시

콘솔이나 UI에 정보를 출력합니다. 아래 샘플 코드(독립 실행을 위해 주석 처리됨)는 각 속성을 출력하는 방법을 보여줍니다:

Console.WriteLine($"File type: {info.FileType}\\
Number of pages: {info.PageCount}\\
Document size: {info.SizeInBytes} bytes");

왜 GroupDocs.Redaction을 메타데이터 추출에 사용해야 할까요?

GroupDocs.Redaction은 50개 이상의 파일 형식을 지원하며, 2 GB까지의 문서를 100 MB 이하의 메모리 사용량으로 처리할 수 있습니다. 문서를 완전히 로드하지 않고 메타데이터만 추출하므로 빠른 응답을 제공하며, 일반 서버 하드웨어에서 100페이지 PDF의 경우 200 ms 이하로 처리됩니다.

일반적인 문제와 해결책

  • 잘못된 파일 경로 – 경로 문자열을 확인하고 파일이 실행 프로세스에서 접근 가능한지 확인하세요.
  • 지원되지 않는 형식 – 형식 목록을 확인하고 누락된 경우 먼저 변환을 고려하세요.
  • 성능 병목 – 매우 큰 파일의 경우 스트리밍 옵션을 활성화하거나 페이지를 배치로 처리해 메모리 사용을 제한하세요.

실용적인 적용 사례

문서 메타데이터를 이해하면 다음과 같은 실제 시나리오에 활용할 수 있습니다:

  1. 문서 관리 시스템(DMS) – 유형, 크기, 페이지 수를 기준으로 자동 분류 및 인덱싱.
  2. 규정 준수 감사 – 보관 전 기밀 파일에 필수 메타데이터가 포함되어 있는지 검증.
  3. 데이터 마이그레이션 – 속성별로 파일을 그룹화해 대량 마이그레이션 작업을 효율화.

성능 고려 사항

  • 효율적인 리소스 사용 – Redactor 인스턴스를 using 블록 내에서 사용해 적절히 해제합니다.
  • 비동기 패턴 – 메타데이터 호출을 Task.Run으로 래핑하거나 async 래퍼를 구현해 데스크톱·웹 앱에서 UI 스레드가 응답하도록 유지합니다.

자주 묻는 질문

Q: 어떤 문서 형식에서 메타데이터를 추출할 수 있나요?
A: PDF, DOCX, XLSX, PPTX, HTML 및 일반 이미지 형식을 포함해 50개 이상을 지원합니다.

Q: 비밀번호로 보호된 파일은 어떻게 처리하나요?
A: Redactor 생성자에 비밀번호를 전달하면 API가 메타데이터를 추출하기 전에 파일을 복호화합니다.

Q: 처리할 수 있는 파일 크기에 제한이 있나요?
A: 명확한 제한은 없지만 2 GB를 초과하는 파일은 추가 메모리 튜닝이 필요할 수 있으며, 성능은 파일 크기에 비례합니다.

Q: 메타데이터를 배치 작업으로 가져올 수 있나요?
A: 예—파일 경로 컬렉션을 순회하면서 각 파일에 GetDocumentInfo()를 호출하면 됩니다. 라이브러리는 병렬 실행에 대해 스레드 안전합니다.

Q: 개발 빌드에 라이선스가 필요합니까?
A: 개발 및 테스트에는 무료 체험 라이선스로 충분하지만, 프로덕션 배포 시에는 상용 라이선스가 필요합니다.

리소스

결론

이제 GroupDocs.Redaction .NET을 사용해 메타데이터를 검색하는 방법에 대한 전체 단계별 가이드를 확인했습니다. Redactor.GetDocumentInfo() 메서드를 활용하면 파일 메타데이터를 빠르게 읽어 규정 준수 워크플로를 지원하고, 문서 처리 파이프라인을 강화할 수 있습니다. 콘텐츠 마스킹, 워터마크 삽입, 문서 변환 등 추가 Redaction 기능을 탐색해 완전한 문서 관리 솔루션을 구축해 보세요.

Last Updated: 2026-06-06
Tested With: GroupDocs.Redaction .NET 21.6 (latest at time of writing)
Author: GroupDocs

관련 튜토리얼