포맷 구성

포맷별 렌더링 옵션 전체

모든 문서는 BaseConfig 구현으로 시작합니다. OpenDocumentAsync에 전달하거나 포맷 카탈로그가 기본값을 만들도록 하세요. 아래 모든 클래스는 Doconut 네임스페이스에 존재합니다.

그 단일 네임스페이스는 새로 추가되었습니다. 이전 .NET Standard 라이브러리는 이러한 유형들을 Doconut.Configs, Doconut.Configs.View, Doconut.Models에 분산시켰습니다. 형식 이름은 변경되지 않았습니다 — 대부분의 파일에서 전체 수정은 두 개의 using 라인을 삭제하는 것입니다. 마이그레이션 가이드를 참조하세요.

csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
    AllowSearch = true,
    AllowCopy   = true,
    ImageResolution = 150
});

상속 및 중첩 PDF 설정

모든 포맷은 다섯 개의 BaseConfig 속성을 상속합니다. PDF를 통해 리다이렉트할 수 있는 포맷은 중첩된 PdfConfig을 노출합니다. WordConfig, ExcelConfig, 그리고 PptConfig에서는 AllowSearch와 AllowCopy가 중첩된 PdfConfig을 읽고 쓰는 편의 속성입니다.

DefaultRender = true은(는) 기본 포맷 렌더러를 선택합니다. PDF 리다이렉트가 있는 포맷에서는 false이(가) 먼저 메모리 내 PDF로 변환한 뒤 PDF 뷰어를 사용합니다. 이 경로는 텍스트 좌표 검색에 유용하지만 추가 변환 비용이 발생합니다.

별도로 명시되지 않는 한, 표는 생성자/속성 기본값을 보여줍니다. 자동 포맷 카탈로그는 의도적으로 두 값을 재정의합니다: ExcelConfig을 SplitWorksheets = true와 함께 생성하고, MhtConfig을 DefaultRender = false와 함께 생성합니다.

BaseConfig

유형속성기본값동작
intImageResolution00은(는) 포맷 기본값을 사용합니다. 유효한 명시적 범위는 25-300 DPI이며, 잘못된 할당은 무시됩니다.
stringDocumentCulture""날짜와 숫자의 로케일입니다. 비공백 값은 트림되고, 공백 할당은 무시됩니다.
stringPassword""보호된 문서 비밀번호. DocOptions.Password이(가) 자동으로 여기 복사됩니다.
boolShowUItrue호환성 속성; 현재 렌더러는 브라우저 툴바 제어에 이를 사용하지 않습니다.
boolCachePagestrue문서 세션 동안 렌더링된 페이지 이미지를 캐시합니다.

PdfConfig

포맷: PDF. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue호환성 스위치. 현재 팩토리는 기본 PDF 뷰어를 사용합니다.
boolAllowSearchfalsePDF 텍스트 검색 인덱스를 구축/사용합니다. 요청에 대해 Search 라이선스 기능이 필요합니다.
boolAllowCopyfalse텍스트 선택/복사 작업을 허용합니다.
boolExtractHyperlinksfalse클라이언트 오버레이를 위해 링크 사각형을 추출합니다.
intHyperlinksPageCount0링크를 스캔하는 최대 페이지 수; 0은 모든 페이지를 의미합니다.
boolCompressImagesfalse렌더링 전에 삽입된 이미지를 압축합니다.
intCompressQuality100압축이 활성화될 때 사용되는 JPEG 품질.
boolResizeImagesfalse렌더링 전에 삽입된 이미지를 리사이즈합니다.
intResizeResolution300리사이즈된 이미지의 목표 DPI.
boolCompressFastfalse더 빠르고 낮은 품질의 압축 경로를 선호합니다.
boolFixInvalidImagesfalse잘못된 삽입 이미지를 복구하려 시도합니다.
boolSplitSegmentsfalse검색/복사를 개선하기 위해 줄 구간에 걸쳐 분리된 단어를 다시 결합합니다.

showHyperlinks은(는) ViewerConfig에서 클라이언트 오버레이를 제어하고, ExtractHyperlinks은(는) 서버 추출을 제어합니다. 두 옵션을 모두 활성화하세요.

WordConfig

포맷: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, XML. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 Word 렌더링; false은 PDF 리다이렉트를 사용합니다.
PdfConfigPdfConfignew instancePDF/검색 경로에서 사용되는 설정.
DocPaperSizePaperSizeA4출력 용지 크기. 너비/높이와 함께 Custom을(를) 사용하세요.
intPaperWidth595포인트 단위의 사용자 정의 너비.
intPaperHeight841포인트 단위의 사용자 정의 높이.
boolRemovePaperMarginfalse문서 페이지 여백을 제거합니다.
boolRenderPageColortrueWord에서 설정한 페이지 색상을 유지합니다; false은 흰색 페이지를 렌더링합니다.
boolExportPdfAfalsePDF 경로에서 보관용 PDF/A를 사용합니다.
Encoding?FileEncodingnull소스 인코딩을 재정의합니다.
stringFontInfo""폰트 대체 정보.
string[]?FontFoldersnull추가 폰트 디렉터리 — 문서에서 사용하는 폰트가 없는 서버에 유용합니다.
boolAllowSearchfalsePdfConfig.AllowSearch에 위임합니다.
boolAllowCopyfalsePdfConfig.AllowCopy에 위임합니다.
TableAutoFitBehaviorAutoFitAllTablesNoneNone, AutoFitToContents, 또는 AutoFitToWindow.

Excel 구성

지원 형식: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 시트 렌더링; false 은 PDF 리다이렉트를 사용합니다.
PdfConfigPdfConfig새 인스턴스PDF/검색 경로 설정.
ExcelPaperSizePaperSizePaperA4출력 용지 크기.
doublePaperMargins0.25인치 단위 페이지 여백.
boolPaperLandscapetrue가로 방향 시트 렌더링.
boolAutoFitContentsfalse행 높이와 열 너비를 자동 맞춤.
boolRemoveEmptyContenttrue빈 콘텐츠를 제외하여 출력 압축.
boolCalculateFormulatrue렌더링 전에 수식 재계산.
boolShowRowColumnHeaderstrue스프레드시트 헤더 포함.
boolExportPdfAfalsePDF 경로에 PDF/A 사용.
boolSplitWorksheetsfalse워크시트를 별도 페이지 그룹으로 유지.
boolShowEmptyWorkSheetsfalse빈 워크시트 포함.
boolExportLandscapefalse가로 방향 내보내기 강제.
boolExportOnePagePerSheetfalse각 워크시트를 하나의 출력 페이지에 맞춤.
boolMemoryOptimizationPreferencetrue피크 메모리 감소, 속도가 약간 느려질 수 있음.
boolAutoTrimWorksheetRenderRangetrue명시적 인쇄 영역이 없을 때 사용된 범위만 렌더링.
boolAutoTrimPreserveExistingPrintAreatrue자동 트림 중 워크북 정의 인쇄 영역 보존.
string?PrintAreanull예: "A1:Z100" 와 같은 명시적 범위.
boolPrintGridlinesfalse워크시트 격자선 인쇄.
boolPrintHeadingsfalse행/열 머리글 인쇄.
List<string>SheetNames비어 있음명명된 워크시트만 렌더링 제한.
CustomStyleCell?CustomStylesnull선택적 날짜/소수/정수 형식 재정의.
boolAllowSearchfalsePdfConfig.AllowSearch 에 위임.
boolAllowCopyfalsePdfConfig.AllowCopy 에 위임.

CustomStyleCell 은 CustomStyleDateTime, CustomStyleNumberDecimal, 그리고 CustomStyleNumberInteger 를 노출하며, 모두 null 허용 문자열입니다.

new ExcelConfig() 은 SplitWorksheets 을 false 로 설정합니다; 명시적 구성이 없는 Excel 파일을 열면 형식 카탈로그를 사용하여 이를 true 로 설정합니다.

Ppt 구성

지원 형식: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 슬라이드 렌더링; false 은 PDF 리다이렉트를 사용합니다.
boolFastLoadfalse열 때 첫 슬라이드 렌더링을 피하고 메타데이터를 사용해 필요 시 렌더링.
PdfConfigPdfConfig새 인스턴스PDF/검색 동작 설정.
stringFontInfo""글꼴 대체 정보.
string[]?FontFoldersnull추가 글꼴 디렉터리.
boolAllowSearchfalsePdfConfig.AllowSearch 에 위임.
boolAllowCopyfalsePdfConfig.AllowCopy 에 위임.

프레젠테이션에서 사용하는 글꼴을 서버에 설치하거나, FontFolders 을 해당 글꼴이 들어 있는 폴더로 지정하십시오. 누락된 글꼴은 오류 없이 대체됩니다.

Cad 구성

지원 형식: DWG, DXF, DGN. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 CAD 렌더링; false 은 PDF 리다이렉트를 사용합니다.
PdfConfigPdfConfig새 인스턴스PDF 경로 설정.
boolExportPdfAfalse보관용 PDF/A 출력.
boolShowColortrue흑백 대신 컬러.
boolWhiteBackgroundtrue검은색 배경 대신 흰색 배경.
shortLineWidth25CAD 선 굵기.
boolShowLayoutsfalse레이아웃 탭 렌더링.
boolShowModeltrue모델 공간 렌더링.
boolCheck3DSolidtrue3D 솔리드 처리.
boolExportAllLayoutsfalse모델/레이아웃 선택을 무시하고 모든 레이아웃 내보내기.
boolLimitMinimumSizefalseMinimumSize 적용.
intMinimumSize700최소 출력 크기(픽셀).
boolLimitMaximumSizefalseMaximumSize 적용.
intMaximumSize700최대 출력 크기(픽셀).
boolShowAllLayoutsDgnfalse모든 DGN 레이아웃 포함.
boolAutomaticLayoutScalingtrue레이아웃 자동 스케일링.
floatPdfMargins0.5PDF 여백(인치).
RenderQualityQualityImageLow래스터 품질: Low, Medium, 또는 High.
RenderQualityQualityTextMedium텍스트 품질: Low, Medium, 또는 High.

이메일 구성

지원 형식: EML, EMLX, MSG. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 이메일 렌더링; false 은 PDF 리다이렉트를 사용합니다.
PdfConfigPdfConfig새 인스턴스PDF 경로 설정.
Encoding?EmailEncodingnull메시지 인코딩을 재정의합니다.
Encoding?SubjectEncodingnull제목 인코딩을 재정의합니다.
Encoding?BodyEncodingnull본문 인코딩을 재정의합니다.
boolSkipExternalImagesfalse원격으로 참조된 이미지를 로드하지 않습니다. 신뢰할 수 없는 이메일에 권장됩니다.
boolRemoveLastWhitePagefalse끝에 있는 빈 페이지를 제거합니다.
boolUseAntiAliasingfalse안티앨리어싱을 활성화합니다.
boolUseHighQualityRenderingfalse더 깔끔하지만 느린 렌더링을 선호합니다.
TimeSpan?TimeZoneOffsetnull날짜에 사용되는 시간대를 재정의합니다.
boolForcePageSizefalse고정 페이지 크기를 강제합니다.

이미지 구성, Tiff 구성 및 Psd 구성

ImageConfig 은 JPG, JPEG, JPE, PNG, BMP, GIF, ICO, EPS, TGA, WEBP, CDR, CMX, DNG, EMF, WMF, AVIF 및 SVG 를 지원합니다. 기본 DPI는 100 입니다.

구성속성기본값동작
ImageConfigMaxImagePixelSize3000최대 너비/높이. 0 은 무제한을 의미합니다; 0이 아닌 값이 50 미만이면 무시됩니다.
ImageConfigTransparentPngtruePNG 투명성을 유지합니다; false 은 흰색 배경을 사용합니다.
TiffConfig추가 속성 없음DPI 200BaseConfig 만 사용합니다; 다중 페이지 TIFF를 지원합니다.
PsdConfigMaxImagePixelSize3000동일한 0/minimum-50 검증이 ImageConfig 와 동일합니다; 기본 DPI는 100 입니다.

Dicom 구성

지원 형식: DCM, IMA. 기본 유효 DPI: 100. DICOM 플러그인이 필요합니다. 이 패키지에서는 DICOM 파일이 완전히 렌더링되지만 기술 메타데이터는 제공되지 않습니다 — DICOM 플러그인 을 참조하십시오.

유형속성기본값동작
intHorizontalResolution100 유효명시적 가로 DPI; 그렇지 않으면 ImageResolution, 그 다음 100.
intVerticalResolution100 유효명시적 세로 DPI; 그렇지 않으면 ImageResolution, 그 다음 100.
intAnimationFrameDelayMs100다중 프레임 애니메이션 지연; GIF 타이밍은 10 ms 단위를 사용합니다.
ushortLoopCount00 은 무한 반복합니다; 양수 값은 해당 횟수만큼 반복 후 중지합니다.
DicomDisplayModeDisplayModeAnimationAndFramesAnimationOnly, FramesOnly, 또는 결합된 개요와 정적 프레임.

텍스트 구성

지원 형식: TXT. 기본 DPI: 200.

유형속성기본값동작
DocPaperSizePaperSizeA4출력 용지 크기.
Encoding?FileEncodingnullnull 은 UTF-8 을 사용합니다.
stringFontInformation""텍스트 렌더링을 위한 글꼴 정보.

플레인 텍스트에 더 풍부한 페이지 레이아웃 동작이 필요할 때 WordConfig 를 사용하십시오.

프로젝트 구성

지원 형식: MPP, MPPX, MPX. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 간트 이미지; false 은 텍스트 기반 PDF 경로를 사용합니다.
PdfConfigPdfConfig새 인스턴스PDF 경로 설정.
boolExportPdfAtrue보관용 PDF/A 출력.
MppPaperSizePaperSizeLedger프로젝트 출력 용지 크기.
MppTimeScaleTimeScaleMonthsDays 또는 Months.
MppFormatPresentationFormatGanttChartGanttChart, TaskUsage, ResourceUsage, ResourceSheet, 또는 TaskSheet.

정확한 텍스트-좌표 검색을 위해 DefaultRender = false 를 사용하십시오.

Visio 구성

지원 형식: VSD, VSDX, VSS, VSSX, VST, VSTX, VDX, VSX, VSDM. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 다이어그램 렌더링; false 은 PDF 리다이렉트를 사용합니다.
PdfConfigPdfConfig새 인스턴스PDF 경로 설정.
boolExportPdfAtrue보관용 PDF/A 출력.

Html 구성, Epub 구성, Mht 구성 및 Xps 구성

네 개 모두 기본 DPI가 200 이며 중첩된 PdfConfig 를 노출합니다.

구성형식DefaultRender추가 속성/동작
HtmlConfigHTML, HTMtrue네이티브 렌더링; 텍스트 기반 PDF 검색 경로를 위해 false 를 사용하십시오.
EpubConfigEPUBtrue네이티브 렌더링; false 은 PDF 를 사용합니다.
MhtConfigMHT, MHTMLtrue 은 클래스에, 자동 카탈로그에서는 false일반적인 무구성 열기는 검색 가능한 PDF 리다이렉트를 사용합니다. 명시적으로 구성된 기본 인스턴스는 네이티브로 렌더링합니다.
XpsConfigXPSfalse기본적으로 PDF 경로를 사용합니다; 네이티브 이미지 렌더링을 위해 true 를 설정하십시오.

가족별 구성 예시

csharp
BaseConfig[] configs =
{
    new PdfConfig
    {
        AllowSearch = true,
        ExtractHyperlinks = true,
        HyperlinksPageCount = 0
    },
    new WordConfig
    {
        PaperSize = DocPaperSize.A4,
        RemovePaperMargin = false,
        FontFolders = new[] { Path.Combine(AppContext.BaseDirectory, "Fonts") },
        AllowSearch = true
    },
    new ExcelConfig
    {
        PaperLandscape = true,
        AutoFitContents = true,
        CalculateFormula = true,
        SplitWorksheets = false,
        PrintGridlines = false
    },
    new PptConfig
    {
        FastLoad = true,
        FontFolders = new[] { Path.Combine(AppContext.BaseDirectory, "Fonts") },
        AllowSearch = true
    },
    new CadConfig
    {
        ShowColor = true,
        WhiteBackground = true,
        ShowModel = true,
        ShowLayouts = false,
        QualityText = CadConfig.RenderQuality.High
    },
    new EmailConfig
    {
        SkipExternalImages = true,
        RemoveLastWhitePage = true,
        TimeZoneOffset = TimeSpan.Zero
    },
    new ImageConfig
    {
        MaxImagePixelSize = 3000,
        TransparentPng = true
    },
    new DicomConfig
    {
        DisplayMode = DicomDisplayMode.AnimationAndFrames,
        AnimationFrameDelayMs = 100,
        LoopCount = 0
    }
};

확장자별 선택

csharp
static BaseConfig? ConfigForExtension(string extUpper) => extUpper switch
{
    ".DOC" or ".DOCX" or ".DOT" or ".DOTX" or ".ODT" => new WordConfig
    {
        AutoFitAllTables = WordConfig.TableAutoFitBehavior.AutoFitToWindow,
        PaperSize = DocPaperSize.Tabloid,
        PdfConfig = new PdfConfig { ExtractHyperlinks = true, HyperlinksPageCount = 5, AllowCopy = true }
    },
    ".PDF" => new PdfConfig { AllowSearch = true, AllowCopy = true },
    ".XLS" or ".XLSX" or ".ODS" or ".CSV" => new ExcelConfig { AllowSearch = true, AllowCopy = true },
    ".DCM" or ".IMA" => new DicomConfig { DisplayMode = DicomDisplayMode.AnimationAndFrames },
    // DefaultRender = false → PDF 리다이렉트 → 픽셀 정확도 네이티브 텍스트 검색
    ".HTML" or ".HTM" => new HtmlConfig { DefaultRender = false },
    ".EML" or ".EMLX" or ".MSG" => new EmailConfig { DefaultRender = false },
    _ => null // 형식의 기본 구성으로 폴백
};

이 페이지가 도움이 되었나요?