뷰어

Viewer (namespace Doconut)은 Razor 페이지, MVC 컨트롤러, Blazor 컴포넌트 또는 최소 API에서 문서를 여는 공개 진입점입니다. 이는 sealed이며, AddDoconut()에 의해 transient 서비스로 등록되고 생성자 주입을 통해 해결됩니다 — 직접 인스턴스를 생성하지 마십시오.

Viewer는 요청당 상태를 보유하지 않으며 의도적으로 not IDisposable를 구현하지 않습니다: 문서 세션은 세션 캐시에서 독립적으로 존재하므로 서비스를 폐기해도 열린 문서를 해제할 수 없습니다 (Core Concepts → How the Viewer Works 참조).

OpenDocumentAsync (문서 열기)

문서를 열고 클라이언트 위젯이 이후 모든 요청에 사용하는 세션 토큰을 반환합니다.

// 간단히 열기
string token = await viewer.OpenDocumentAsync(path);

// 포맷별 구성 및 옵션과 함께
token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig { AllowSearch = true, AllowCopy = true },
    new DocOptions { TimeOut = 30 });

// 업로드에서
await using var ms = new MemoryStream();
await file.CopyToAsync(ms);
ms.Position = 0;
token = await viewer.OpenDocumentAsync(ms, new FileInfo(file.FileName));

처리해야 할 예외:

• LicenseException — 발견된 라이선스가 거부됩니다(메시지에 거부 사유가 포함됨) 또는 형식에 더 이상 부여되지 않은 플러그인 기능이 필요합니다. 거부 메시지 없이 캘린더가 만료되면 예외를 발생시키는 대신 워터마크가 적용된 렌더링으로 대체됩니다.
• FormatNotSupportedException — Document format '<extension>' is not supported.
• InvalidDataException — 파일 내용이 손상되었거나 확장자와 일치하지 않습니다.

CloseDocument (문서 닫기)

void CloseDocument(string token)

세션을 캐시에서 제거하고(문서 엔진을 즉시 폐기), 보안 마커를 삭제하며 접근 권한을 회수합니다. 선택 사항 — 슬라이딩 만료가 동일한 정리를 수행하지만, 대용량 문서에 권장됩니다.

GetPageCount (페이지 수 가져오기)

int GetPageCount(string token)

열린 세션의 총 페이지 수입니다. 토큰이 알 수 없거나 만료된 경우 예외를 발생시킵니다.

DocOptions (문서 옵션)

열기당, 형식에 독립적인 옵션 (namespace Doconut):

클래스는 또한 일반 단일 호스트 뷰잉 흐름 외부에 의도적으로 위치한 특수 속성을 노출합니다:

맞춤 워터마크

DocOptions.Watermark 은 여섯 개의 물결표(~) 로 구분된 필드를 사용합니다. 선택적인 선행 ^ 은 모든 모서리 레이아웃을 요청합니다:

^Text~Color~FontSize~FontName~Opacity~Angle

string token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig(),
    new DocOptions
    {
        Watermark = "^Confidential~Red~24~Verdana~80~-45",
        TimeOut = 30
    });

파서는 선택적인 ^ 뒤에 정확히 여섯 개의 필드를 기대합니다. 잘못된 정의는 조용히 사라지는 대신 SDK의 가시적인 Invalid Watermark 대체값으로 교체됩니다.

라이선스 결정

같은 결정이 제공된 페이지 이미지와 주석 내보내기에 적용됩니다. 애니메이션 GIF 출력은 프레임마다 스탬프가 찍힙니다. 따라서 맞춤 워터마크는 평가 워터마크를 교체하거나 억제하는 방법이 아니라 라이선스가 부여된 애플리케이션 기능입니다.

주석 API

서버 측 주석 로드 및 내보내기. 전체 안내서는 가이드 → 주석에 있습니다; 개요는 다음과 같습니다:

DICOM 메타데이터

Task<DicomMetadata?> GetDicomMetadataAsync(string token, CancellationToken ct = default)

DICOM 플러그인을 통해 열린 세션에 대한 DICOM 태그 메타데이터를 반환합니다; 비-DICOM 문서의 경우 null.

리소스 도우미 — ReferenceCss / ReferenceScripts

임베디드 리소스를 제공하는 UseDoconutResources() 에 대해 올바른 종속 순서로 <link>/<script> 태그를 내보냅니다. 검색 및 주석과 같은 라이선스 제한 기능을 위한 번들은 라이선스가 이를 활성화할 때만 내보내어 클라이언트 UI가 서버 동작과 일치하도록 유지합니다.

string ReferenceCss(CssConfig? config = null)      // null → Bootstrap + 뷰어 + 검색 + 주석
string ReferenceScripts(ScriptConfig? config = null)

CssConfig 플래그: IncludeBootstrapCss, IncludeViewerCss, IncludeSearchCss (검색 제한), IncludeAnnotationCss (주석 제한).

ScriptConfig 플래그: IncludeJQuery (모두에게 필요), IncludeBootstrap, IncludeViewerScripts (핵심: docViewer.js + splitter + links), IncludeSearchScripts 및 IncludeSearchBar (검색 제한), IncludeAnnotationScripts 및 IncludeAnnotationBar (주석 제한).

@inject Doconut.Viewer Viewer

@Html.Raw(Viewer.ReferenceCss(new CssConfig { IncludeBootstrapCss = true, IncludeViewerCss = true }))
@Html.Raw(Viewer.ReferenceScripts(new ScriptConfig { IncludeJQuery = true, IncludeViewerScripts = true }))

GetWorksheetNames

IReadOnlyList<string> GetWorksheetNames(string token)

열려 있는 스프레드시트의 워크시트 이름을 워크북 순서대로 반환하며, 열려 있는 문서가 스프레드시트가 아닌 경우 빈 목록을 반환합니다.

26.9.0에 추가되었습니다.