뷰어

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)

이 메서드는 API 정렬을 위해 존재하지만, .NET 6 DICOM 뷰어는 기술 태그를 제공할 수 없습니다.
null은 DICOM 및 비-DICOM 세션에 대해 반환됩니다; DICOM 세션에서는
플랫폼 제한을 설명하는 일회성 경고도 기록합니다. 페이지, 프레임 및
애니메이션 렌더링은 계속 지원됩니다.

리소스 헬퍼 — ReferenceCss / ReferenceScripts

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

string ReferenceCss(CssConfig? config = null)      // null → Bootstrap + viewer + search + annotation
string ReferenceScripts(ScriptConfig? config = null)

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

ScriptConfig flags: 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에 추가되었습니다.