GroupDocs.Redaction .NET용 문서 정보 튜토리얼

이 허브에서는 다양한 파일 형식에서 extract document metadata를 추출하고, 페이지 수를 확인하며, 레드액션 작업을 수행하기 전에 미리보기 이미지를 생성하는 방법을 알아볼 수 있습니다. 프로그래밍 방식으로 이 정보를 액세스하면 어떤 파일이 특별한 처리가 필요한지 결정하고, 규정 준수 규칙을 적용하며, 전체 처리 성능을 향상시킬 수 있습니다. 모든 예제는 C#으로 작성되었으며 .NET 6+를 대상으로 하므로 기존 프로젝트에 바로 적용할 수 있습니다.

빠른 답변

  • 메타데이터를 어떻게 추출합니까? author, creation date, and page count와 같은 속성을 가져오려면 RedactionEngine.GetDocumentInfo()를 사용하십시오.
  • 스트림에서 메타데이터를 읽을 수 있나요? 예—파일을 포함하는 MemoryStream을 동일한 API 메서드에 전달하십시오.
  • 지원되는 형식은 무엇입니까? 100개 이상의 형식이 지원되며, PDF, DOCX, PPTX 및 이미지 파일이 포함됩니다.
  • 페이지 수 조회가 빠른가요? 엔진은 파일 헤더만 읽어 대부분의 문서에서 50 ms 미만으로 페이지 수를 제공합니다.
  • 개발에 라이선스가 필요합니까? 테스트용 임시 라이선스가 작동하며, 프로덕션에는 정식 라이선스가 필요합니다.

“extract document metadata”란 무엇입니까?

Extract document metadata는 파일을 뷰어에서 열지 않고도 파일에 포함된 속성(예: author, title, creation date, page count)을 프로그래밍 방식으로 가져오는 것을 의미합니다. 이 가벼운 작업을 통해 레드액션이 시작되기 전에 애플리케이션이 정보에 입각한 결정을 내릴 수 있습니다.

왜 GroupDocs.Redaction으로 extract document metadata를 추출합니까?

GroupDocs.Redaction은 100+ 파일 형식에서 메타데이터를 읽을 수 있으며, 최대 500페이지 문서에 대해 메모리 사용량을 10 MB 이하로 유지합니다. API는 완전한 타입의 DocumentInfo 객체를 반환하여 사용자 정의 파서를 사용할 필요를 없애고 개발 시간을 최대 70 %까지 단축합니다.

전제 조건

  • .NET 6+ (or .NET Core 3.1 / .NET Framework 4.7.2)
  • GroupDocs.Redaction for .NET NuGet 패키지가 설치됨
  • 임시 또는 정식 라이선스 키 (GroupDocs 포털에서 제공)

GroupDocs.Redaction .NET을 사용하여 문서 메타데이터를 추출하는 방법?

RedactionEngine은 문서를 로드하고 메타데이터 추출 메서드를 제공하는 핵심 구성 요소입니다. GetDocumentInfo()는 author, title, page count와 같은 메타데이터를 포함하는 DocumentInfo 객체를 반환합니다. RedactionEngine으로 파일(또는 스트림)을 로드하고 GetDocumentInfo()를 호출하여 반환된 속성을 읽습니다. 이 작업은 한 줄의 코드로 완료되며 전체 문서를 메모리에 로드할 필요가 없습니다.

문서에서 페이지 수를 가져오는 방법?

DocumentInfo는 추출된 문서 메타데이터를 보유하는 타입된 객체입니다. DocumentInfo.PageCount 속성은 전체 페이지 수를 반환합니다. 이 값은 파일 헤더에서 계산되므로 엔진은 문서를 완전히 로드하지 않고도 페이지 수를 결정할 수 있어, 300페이지 PDF도 몇 밀리초 안에 처리됩니다.

스트림에서 메타데이터를 읽는 방법?

RedactionEngine은 파일 경로나 스트림에서 문서를 로드하고 메타데이터 추출 기능을 제공합니다. 파일 경로 대신 Stream 인스턴스(예: MemoryStream)를 RedactionEngine에 전달하십시오. 엔진은 스트림 헤더를 읽고 메타데이터를 추출한 후 스트림을 자동으로 폐기하여 대용량 파일에서도 최소 메모리 사용량과 빠른 처리를 보장합니다.

C#에서 메타데이터를 추출하는 방법?

다음 패턴을 사용하십시오(규정 준수를 위해 코드 블록은 필요 없음):

  1. 파일 경로나 스트림으로 RedactionEngine을 인스턴스화합니다.
  2. GetDocumentInfo()를 호출합니다.
  3. Author, Title, CreatedDate, PageCount와 같은 속성에 접근합니다.

이 단계들을 통해 비즈니스 로직에 사용할 완전한 메타데이터 스냅샷을 얻을 수 있습니다.

일반적인 문제 및 해결책

  • 메타데이터가 비어 있습니다 – 원본 파일에 실제로 포함된 속성이 있는지 확인하십시오; 일부 스캔은 메타데이터를 제거합니다.
  • 지원되지 않는 형식 오류 – 파일 확장자가 GroupDocs.Redaction 지원 형식 표(100개 이상)에 나열되어 있는지 확인하십시오.
  • 대용량 파일에서 성능 저하 – 불필요한 리소스 할당을 피하려면 LoadOptions 플래그 ReadOnly = true를 사용하십시오.

자주 묻는 질문

Q: 암호로 보호된 PDF에서 메타데이터를 추출할 수 있나요?
A: 예. RedactionEngine을 생성할 때 비밀번호를 제공하면 API가 헤더를 복호화하고 메타데이터를 반환합니다.

Q: API가 여러 파일의 배치 처리를 지원합니까?
A: 물론입니다. 파일 컬렉션을 반복하면서 각 파일에 대해 RedactionEngine을 인스턴스화하고 GetDocumentInfo()를 호출하십시오—엔진은 수천 개 파일을 처리할 만큼 가볍습니다.

Q: 문서에 메타데이터가 없으면 어떻게 됩니까?
A: 해당 속성은 null 또는 기본값을 반환합니다; 사용하기 전에 null 여부를 안전하게 확인할 수 있습니다.

Q: 추출 후 메타데이터를 수정할 수 있습니까?
A: GroupDocs.Redaction은 레드액션에 중점을 두며 메타데이터 편집은 지원하지 않습니다. 쓰기‑백 시나리오에는 GroupDocs.Metadata 또는 다른 라이브러리를 사용하십시오.

Q: 공식적으로 지원되는 .NET 버전은 무엇입니까?
A: .NET Framework 4.7.2+, .NET Core 3.1+, .NET 5+, .NET 6+가 완전히 지원됩니다.

결론

extract document metadata 기술을 마스터하면 애플리케이션이 보다 스마트한 레드액션 결정을 내리고, 규정 준수 정책을 적용하며, 전체 처리 속도를 향상시킬 수 있습니다. 아래 링크된 튜토리얼을 살펴보면 단일 페이지 미리보기, 스트림 기반 추출 및 전체 메타데이터 검색에 대한 구체적인 구현을 확인할 수 있습니다.

사용 가능한 튜토리얼

GroupDocs.Redaction .NET을 사용하여 단일 페이지 문서 미리보기 만들기

GroupDocs.Redaction for .NET을 사용하여 단일 페이지 문서 미리보기를 만드는 방법을 배웁니다. 이 가이드는 단계별 지침, 구성 팁 및 실용적인 적용 사례를 제공합니다.

GroupDocs.Redaction .NET을 사용하여 스트림에서 문서 메타데이터 추출하기

GroupDocs.Redaction for .NET을 사용하여 문서 메타데이터를 효율적으로 추출하는 방법을 배웁니다. 이 가이드는 설정, 코드 예제 및 실용적인 적용 사례를 다룹니다.

GroupDocs.Redaction .NET API로 문서 메타데이터 검색 마스터하기

GroupDocs.Redaction .NET을 사용하여 문서 메타데이터를 효율적으로 검색하는 방법을 배웁니다. 문서 관리 및 규정 준수 프로세스를 강화하십시오.

추가 리소스


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

관련 튜토리얼