Format Yapılandırmaları

Her belge, bir BaseConfig uygulamasıyla açılır. Birini OpenDocumentAsync'e geçirin veya format kataloğunun varsayılanını oluşturmasına izin verin. Aşağıdaki tüm sınıflar Doconut ad alanında bulunur.

Bu tek ad alanı yeni. Önceki .NET Standard kütüphanesi bu türleri Doconut.Configs, Doconut.Configs.View ve Doconut.Models arasında dağıtmıştı. Tür adları değişmedi — çoğu dosyada tek düzenleme iki using satırını silmek. Bkz. göç rehberi.

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

Kalıtım ve iç içe PDF ayarları

Her format, beş BaseConfig özelliğini devralır. PDF üzerinden yönlendirebilen formatlar iç içe bir PdfConfig sunar. WordConfig, ExcelConfig ve PptConfig içinde AllowSearch ve AllowCopy, iç içe PdfConfig'i okuyan ve yazan kolaylık özellikleridir.

DefaultRender = true yerel format işleyicisini seçer. PDF yönlendirmeli formatlarda, false önce bellekte bir PDF'ye dönüştürür ve ardından PDF görüntüleyiciyi kullanır. Bu yol genellikle metin‑koordinat araması için faydalıdır, ancak ek bir dönüşüm maliyeti getirir.

Aksi belirtilmedikçe, tablolar yapıcı/özellik varsayılanlarını gösterir. Otomatik format kataloğu bilinçli olarak ikisini geçersiz kılar: ExcelConfig'i SplitWorksheets = true ile ve MhtConfig'i DefaultRender = false ile oluşturur.

BaseConfig

PdfConfig

Formatlar: PDF. Varsayılan DPI: 200.

ViewerConfig içindeki showHyperlinks, istemci bindirmesini kontrol eder, ExtractHyperlinks ise sunucu çıkarımını kontrol eder. İkisini de etkinleştirin.

WordConfig

Formatlar: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, XML. Varsayılan DPI: 200.

ExcelConfig

Biçimler: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. Varsayılan DPI: 200.

CustomStyleCell, CustomStyleDateTime, CustomStyleNumberDecimal ve CustomStyleNumberInteger adlı, tümü nullable string olan özellikleri ortaya çıkarır.

new ExcelConfig() SplitWorksheets özelliğini false olarak ayarlar; açık bir yapılandırma olmadan bir Excel dosyası açmak format kataloğunu kullanır ve bu da onu true yapar.

PptConfig

Biçimler: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. Varsayılan DPI: 200.

Linux ve macOS'ta, mevcut motorla sunum render'ı libgdiplus ve System.Drawing.EnableUnixSupport=true gerektirir. Sunumda kullanılan yazı tiplerini kurun veya FontFolders sağlayın.

CadConfig

Biçimler: DWG, DXF, DGN. Varsayılan DPI: 200.

EmailConfig

Biçimler: EML, EMLX, MSG. Varsayılan DPI: 200.

ImageConfig, TiffConfig ve PsdConfig

ImageConfig JPG, JPEG, JPE, PNG, BMP, GIF, ICO, EPS, TGA, WEBP, CDR, CMX, DNG, EMF, WMF, AVIF ve SVG formatlarını kapsar. Varsayılan DPI'sı 100.

DicomConfig

Biçimler: DCM, IMA. Varsayılan etkili DPI: 100. DICOM eklentisi gerektirir.

TxtConfig

Biçim: TXT. Varsayılan DPI: 200.

Düz metnin daha zengin sayfa düzeni davranışı gerektirdiğinde WordConfig kullanın.

ProjectConfig

Biçimler: MPP, MPPX, MPX. Varsayılan DPI: 200.

Tam metin-koordinat araması için DefaultRender = false kullanın.

VisioConfig

Biçimler: VSD, VSDX, VSS, VSSX, VST, VSTX, VDX, VSX, VSDM. Varsayılan DPI: 200.

HtmlConfig, EpubConfig, MhtConfig ve XpsConfig

Dört yapı da varsayılan olarak 200 DPI'ye sahiptir ve iç içe bir PdfConfig sunar.

Aileye göre yapılandırma örnekleri

BaseConfig[] configs =
{
    new PdfConfig
    {
        AllowSearch = true,
        ExtractHyperlinks = true,
        HyperlinksPageCount = 0
    },
    new WordConfig
    {
        PaperSize = DocPaperSize.A4,
        RemovePaperMargin = false,
        FontFolders = new[] { "/usr/share/fonts/truetype" },
        AllowSearch = true
    },
    new ExcelConfig
    {
        PaperLandscape = true,
        AutoFitContents = true,
        CalculateFormula = true,
        SplitWorksheets = false,
        PrintGridlines = false
    },
    new PptConfig
    {
        FastLoad = true,
        FontFolders = new[] { "/usr/share/fonts/truetype" },
        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
    }
};

Uzantıya göre seçim

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 redirect → pixel-accurate native text search
    ".HTML" or ".HTM" => new HtmlConfig { DefaultRender = false },
    ".EML" or ".EMLX" or ".MSG" => new EmailConfig { DefaultRender = false },
    _ => null // fall back to the format's default config
};