GroupDocs.Redaction을 사용하여 .NET에서 지원되는 파일 형식 표시

다양한 문서 유형을 관리하는 것은 .NET 개발자에게 일상적인 현실입니다. GroupDocs.Redaction을 사용하면 라이브러리가 지원하는 파일 확장자 목록을 확인할 수 있어 애플리케이션이 업로드를 허용하거나 거부하고, 친숙한 UI 옵션을 제공하며, 비용이 많이 드는 런타임 오류를 방지할 수 있습니다. 이 튜토리얼은 전제 조건부터 완전한 프로덕션 준비 구현까지 필요한 모든 과정을 안내하므로 솔루션에서 파일 형식 가져오기 및 c# 파일 형식 표시를 자신 있게 수행할 수 있습니다.

빠른 답변

  • “list file extensions”는 무엇을 의미하나요? API에서 지원되는 파일 유형 식별자 컬렉션(예: .pdf, .docx)을 가져오는 것을 의미합니다.
  • 어떤 NuGet 패키지가 이 기능을 제공하나요? GroupDocs.Redaction (최신 안정 버전).
  • 샘플을 실행하려면 라이선스가 필요합니까? 개발에는 무료 체험 라이선스로 충분하지만, 프로덕션에는 영구 라이선스가 필요합니다.
  • 결과를 캐시할 수 있나요? 예—목록을 메모리 또는 분산 캐시에 저장하여 반복적인 API 호출을 방지할 수 있습니다.
  • 이 기능이 .NET 6 및 .NET Core와 호환되나요? 물론입니다; 라이브러리는 .NET Framework 4.5+, .NET Core 3.1+, .NET 5+, 및 .NET 6+를 지원합니다.

GroupDocs.Redaction이란?

GroupDocs.Redaction은 개발자가 민감한 콘텐츠를 가리고, 문서를 변환하며, 지원되는 파일 유형을 확인할 수 있게 해주는 .NET 라이브러리이며, 서버에 Microsoft Office가 필요하지 않습니다. 복잡한 형식 처리를 깔끔한 객체 지향 API 뒤에 추상화합니다. 이 라이브러리는 PDF, Office 문서, 이미지 등 다양한 형식을 처리하면서 높은 성능과 보안을 보장하는 가리기, 변환 및 형식 탐지를 위한 통합 API를 제공합니다.

왜 GroupDocs.Redaction으로 파일 확장자를 나열해야 할까요?

이 라이브러리는 PDF, DOCX, PPTX, XLSX, HTML 및 30가지 이상의 이미지 유형을 포함하여 50개 이상의 입력 및 출력 형식을 지원합니다. 프로그램matically 파일 확장자를 나열함으로써 다음을 할 수 있습니다:

  • 지원되지 않는 파일 업로드를 방지하여 검증 오류를 최대 90%까지 감소시킵니다.
  • 드롭다운 메뉴를 동적으로 채워 UI가 라이브러리 업데이트와 동기화되도록 합니다.
  • 사용자가 처리하려고 시도한 정확한 파일 유형을 기록하는 감사 로그를 구축합니다.

전제 조건

  • GroupDocs.Redaction: NuGet을 통해 설치합니다(아래 명령어 참조).
  • .NET SDK: 최신 .NET SDK가 설치되어 있는지 확인하세요. 여기에서 다운로드할 수 있습니다.
  • IDE: Visual Studio 2022 또는 호환 가능한 편집기.
  • 기본 C# 지식: 컬렉션 및 LINQ에 익숙해야 합니다.

.NET용 GroupDocs.Redaction 설정

라이브러리 설치

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI

  • NuGet 패키지 관리자를 열고 “GroupDocs.Redaction”을 검색한 뒤 최신 버전을 설치합니다.

라이선스 획득 및 적용

제한 없이 전체 기능을 탐색하려면 무료 체험 또는 임시 라이선스를 요청하세요. 구매 옵션은 GroupDocs 구매 페이지를 방문하십시오. 라이선스 파일을 확보하면:

  1. 프로젝트 내 접근 가능한 폴더에 배치합니다(예: ./Licenses/GroupDocs.Redaction.lic).
  2. 애플리케이션 시작 시 라이선스를 초기화합니다:

License 클래스는 라이선스 파일을 로드하고 GroupDocs.Redaction을 활성화합니다.

   using GroupDocs.Redaction.License;
   
   License lic = new License();
   lic.SetLicense("path/to/your/license/file");

GroupDocs.Redaction을 사용하여 파일 확장자를 나열하는 방법

Redaction API를 로드하고 지원되는 형식을 반환하는 메서드를 호출합니다. 이 호출은 각 항목에 확장자와 사람이 읽을 수 있는 설명이 포함된 컬렉션을 반환합니다. 이 작업은 가볍고 시작 시 또는 필요 시 수행할 수 있습니다.

지원되는 파일 유형 가져오기

RedactionApi.GetSupportedFileFormats() 메서드는 각 형식을 설명하는 FileFormatInfo 객체의 읽기 전용 컬렉션을 반환합니다.

using GroupDocs.Search.Results;
using System;
using System.Collections.Generic;

// Using LINQ to order the supported file formats by their extensions.
IEnumerable<FileType> supportedFileTypes = FileType.GetSupportedFileTypes()
    .OrderBy(ft => ft.Extension);

각 확장자와 설명 표시

각 FileFormatInfo는 파일 유형에 대한 Extension 및 Description 속성을 제공합니다.

foreach (FileType fileType in supportedFileTypes)
{
    Console.WriteLine(fileType.Extension.PadRight(8) + " - " + fileType.Description);
}

설명: 루프는 각 FileFormatInfo 객체를 순회하면서 Extension과 Description을 깔끔하게 정렬된 표 형태로 출력합니다.

목록을 UI 드롭다운에 통합하는 방법

컬렉션을 확보한 후에는 WinForms ComboBox, WPF ComboBox 또는 ASP.NET Core select 요소와 같은 UI 구성 요소에 바인딩합니다. 핵심은 Extension을 값으로, Description을 표시 텍스트로 사용하는 것입니다. 이렇게 하면 사용자는 친숙한 이름을 보면서 코드에서는 정확한 확장자 문자열을 사용할 수 있습니다.

일반적인 문제 및 해결책

  • Missing namespace 오류 – GroupDocs.Redaction 및 GroupDocs.Redaction.Common을 임포트했는지 확인하세요.
  • License not found – 라이선스 파일 경로가 올바른지, 파일이 빌드 출력에 포함되었는지 확인하세요.
  • 대규모 프로젝트에서의 성능 – 정적 변수 또는 분산 캐시(예: Redis)에 결과를 캐시하여 반복적인 열거를 방지하세요.

실용적인 적용 사례

지원되는 정확한 확장자 목록을 알면 여러 실제 시나리오를 구현할 수 있습니다:

  1. 문서 관리 시스템 – 확장자를 기반으로 들어오는 파일을 자동 분류합니다.
  2. 콘텐츠 필터링 도구 – 업로드 시 허용되지 않은 형식(예: 실행 파일)을 차단합니다.
  3. 파일 변환 파이프라인 – 파일을 변환할 수 있는지 동적으로 판단하거나 대체 워크플로가 필요한지 결정합니다.

성능 고려 사항

  • 메모리 사용량 – 형식 목록은 가벼운 IReadOnlyCollection에 저장되며 일반적으로 2 KB 이하입니다.
  • 스레드 안전성 – 컬렉션은 생성 후 불변이며, 동시 읽기에 안전합니다.
  • 캐싱 – 트래픽이 많은 API의 경우, 애플리케이션 수명 동안 목록을 캐시하여 요청당 몇 마이크로초의 오버헤드를 없앨 수 있습니다.

결론

위 단계들을 따라 하면 이제 GroupDocs.Redaction을 사용하여 파일 확장자를 나열하고 c# 파일 형식 표시하는 신뢰할 수 있는 방법을 갖게 됩니다. 이 기능은 사용자 경험을 향상시킬 뿐만 아니라 백엔드를 지원되지 않는 파일로부터 보호합니다. 콘텐츠 마스킹, PDF 가리기, 배치 처리와 같은 추가 Redaction 기능을 탐색하여 문서 워크플로를 더욱 강화하세요.

자주 묻는 질문

Q: 기본 지원 파일 형식은 무엇인가요?
A: GroupDocs.Redaction은 PDF, DOCX, PPTX, XLSX, HTML, BMP, JPEG, PNG 등 50개 이상의 형식을 지원합니다. 전체 목록은 GroupDocs 문서에서 확인하세요.

Q: 라이브러리를 최신 버전으로 업그레이드하려면 어떻게 해야 하나요?
A: NuGet 패키지 관리자를 열고 “GroupDocs.Redaction”을 검색한 뒤 Update를 클릭합니다. 또는 dotnet add package GroupDocs.Redaction --version <latest> 명령을 실행하세요.

Q: 이 목록을 서버 측 업로드 파일 검증에 사용할 수 있나요?
A: 예—처리하기 전에 업로드된 파일의 확장자를 가져온 컬렉션과 비교하면 잘못된 형식 오류의 99%를 제거할 수 있습니다.

Q: 사용자 정의 파일 유형을 지원하도록 확장할 수 있나요?
A: 사용자 정의 확장자는 사용자 정의 핸들러가 필요하며, 핵심 라이브러리는 새로운 형식을 기본적으로 추가하지 않습니다. 사용자 정의 가져오기/내보내기 파이프라인을 만들려면 API 문서를 검토하세요.

Q: 코드를 추가한 후 애플리케이션이 충돌합니다—무엇을 확인해야 하나요?
A: 라이선스가 올바르게 로드되었는지, using 문이 올바른 네임스페이스를 참조하고 있는지, 라이선스 파일을 읽을 때 IOException을 처리했는지 확인하세요.

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

리소스

관련 튜토리얼