Biçim Yapılandırmaları

Biçim başına tam render seçenekleri

Her belge, bir BaseConfig uygulamasıyla açılır. Birini OpenDocumentAsync'a gönderin 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ı yenidir. Ö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 tüm düzenleme iki using satırını silmekten ibarettir. Bkz. geçiş rehberi.

csharp
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 ortaya çıkarır. WordConfig, ExcelConfig ve PptConfig içinde, AllowSearch ve AllowCopy, iç içe PdfConfig'ı okuyan ve yazan kullanışlı özelliklerdir.

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, metin-koordinat araması için sıkça yararlıdır, ancak ek bir dönüşüm maliyeti gerektirir.

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

BaseConfig

TürÖzellikVarsayılanDavranış
intImageResolution00 format varsayılanını kullanır. Geçerli açık aralık 25-300 DPI'dir; geçersiz atamalar yok sayılır.
stringDocumentCulture""Tarih ve sayılar için yerel ayar. Boş olmayan değerler kırpılır; boş atamalar yok sayılır.
stringPassword""Korunan belge şifresi. DocOptions.Password burada otomatik olarak kopyalanır.
boolShowUItrueUyumluluk özelliği; mevcut işleyici bunu tarayıcı araç çubuğunu kontrol etmek için kullanmaz.
boolCachePagestrueBelge oturumu için işlenmiş sayfa görüntülerini önbellekle.

PdfConfig

Formatlar: PDF. Varsayılan DPI: 200.

TürÖzellikVarsayılanDavranış
boolDefaultRendertrueUyumluluk anahtarı. Mevcut fabrika yerel PDF görüntüleyiciyi kullanır.
boolAllowSearchfalsePDF metin arama indeksini oluştur/kullan. İstekler için Arama lisans yeteneği gerekir.
boolAllowCopyfalseMetin seçme/kopyalama işlemlerine izin ver.
boolExtractHyperlinksfalseİstemci katmanları için bağlantı dikdörtgenlerini çıkar.
intHyperlinksPageCount0Bağlantılar için taranan maksimum sayfa; 0 her sayfa anlamına gelir.
boolCompressImagesfalseİşleme öncesi gömülü görüntüleri sıkıştır.
intCompressQuality100Sıkıştırma etkin olduğunda kullanılan JPEG kalitesi.
boolResizeImagesfalseİşleme öncesi gömülü görüntüleri yeniden boyutlandır.
intResizeResolution300Yeniden boyutlandırılmış görüntüler için hedef DPI.
boolCompressFastfalseDaha hızlı, düşük kaliteli sıkıştırma yolunu tercih et.
boolFixInvalidImagesfalseGeçersiz gömülü görüntüleri onarmayı dene.
boolSplitSegmentsfalseArama/kopyayı iyileştirmek için satır segmentleri arasında bölünmüş kelimeleri birleştir.

showHyperlinks, ViewerConfig içinde istemci katmanını kontrol eder, ExtractHyperlinks ise sunucu çıkarımını kontrol eder. İkisini de etkinleştir.

WordConfig

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

TürÖzellikVarsayılanDavranış
boolDefaultRendertrueYerel Word render; false PDF yönlendirmesini kullanır.
PdfConfigPdfConfignew instancePDF/arama yolunda kullanılan ayarlar.
DocPaperSizePaperSizeA4Çıktı kağıt boyutu. Genişlik/yükseklik için Custom kullan.
intPaperWidth595Nokta cinsinden özel genişlik.
intPaperHeight841Nokta cinsinden özel yükseklik.
boolRemovePaperMarginfalseBelge sayfa kenar boşluklarını kaldır.
boolRenderPageColortrueWord'ün ayarlanmış sayfa rengini koru; false beyaz sayfalar render eder.
boolExportPdfAfalsePDF yolunda arşiv PDF/A kullan.
Encoding?FileEncodingnullKaynak kodlamayı geçersiz kıl.
stringFontInfo""Yazı tipi ikame bilgisi.
string[]?FontFoldersnullEk yazı tipi dizinleri — belgelerin kullandığı yazı tiplerine sahip olmayan bir sunucuda faydalıdır.
boolAllowSearchfalsePdfConfig.AllowSearch'a delege eder.
boolAllowCopyfalsePdfConfig.AllowCopy'a delege eder.
TableAutoFitBehaviorAutoFitAllTablesNoneNone, AutoFitToContents veya AutoFitToWindow.

ExcelConfig

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

TürÖzellikVarsayılanDavranış
boolDefaultRendertrueYerel sayfa render'ı; false PDF yönlendirmesini kullanır.
PdfConfigPdfConfignew instancePDF/arama yolu ayarları.
ExcelPaperSizePaperSizePaperA4Çıktı kağıt boyutu.
doublePaperMargins0.25Sayfa kenar boşlukları inç cinsinden.
boolPaperLandscapetrueYatay sayfa render'ı.
boolAutoFitContentsfalseSatır yüksekliği ve sütun genişliğini otomatik sığdır.
boolRemoveEmptyContenttrueBoş içeriği dışarıda bırakarak çıktıyı sıkılaştır.
boolCalculateFormulatrueRender'dan önce formülleri yeniden hesapla.
boolShowRowColumnHeaderstrueElektronik tablo başlıklarını dahil et.
boolExportPdfAfalsePDF yolunda PDF/A kullan.
boolSplitWorksheetsfalseÇalışma sayfalarını ayrı sayfa grupları olarak tut.
boolShowEmptyWorkSheetsfalseBoş çalışma sayfalarını dahil et.
boolExportLandscapefalseYatay dışa aktarmayı zorla.
boolExportOnePagePerSheetfalseHer çalışma sayfasını tek bir çıktı sayfasına sığdır.
boolMemoryOptimizationPreferencetrueTepe bellek kullanımını azalt, muhtemelen biraz hız kaybı ile.
boolAutoTrimWorksheetRenderRangetrueAçık bir yazdırma alanı yoksa yalnızca görünen kullanılan aralığı render et.
boolAutoTrimPreserveExistingPrintAreatrueOtomatik kırpma sırasında çalışma kitabı tanımlı yazdırma alanlarını koru.
string?PrintAreanullÖrneğin "A1:Z100" gibi açık aralık.
boolPrintGridlinesfalseÇalışma sayfası ızgaralarını yazdır.
boolPrintHeadingsfalseSatır/sütun başlıklarını yazdır.
List<string>SheetNamesemptyRender'ı yalnızca adlandırılmış çalışma sayfalarına kısıtla.
CustomStyleCell?CustomStylesnullİsteğe bağlı tarih/ondalık/tamsayı biçimlendirme geçersiz kılmaları.
boolAllowSearchfalsePdfConfig.AllowSearch'a delege eder.
boolAllowCopyfalsePdfConfig.AllowCopy'a delege eder.

CustomStyleCell, CustomStyleDateTime, CustomStyleNumberDecimal ve CustomStyleNumberInteger'ı ortaya çıkarır, hepsi nullable string'ler.

new ExcelConfig(), SplitWorksheets'ı 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 olarak ayarlar.

PptConfig

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

TürÖzellikVarsayılanDavranış
boolDefaultRendertrueYerel slayt render'ı; false PDF yönlendirmesini kullanır.
boolFastLoadfalseAçılışta ilk slaytı render etmemek; meta verileri kullan ve talep üzerine render et.
PdfConfigPdfConfignew instancePDF/arama davranışı ayarları.
stringFontInfo""Yazı tipi ikame bilgisi.
string[]?FontFoldersnullEk yazı tipi dizinleri.
boolAllowSearchfalsePdfConfig.AllowSearch'a delege eder.
boolAllowCopyfalsePdfConfig.AllowCopy'a delege eder.

Sunucuda sunumların kullandığı yazı tiplerini kurun veya FontFolders'ı onları içeren bir klasöre yönlendirin. Eksik yazı tipleri hatasız olarak ikame edilir.

CadConfig

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

TürÖzellikVarsayılanDavranış
boolDefaultRendertrueYerel CAD render'ı; false PDF yönlendirmesini kullanır.
PdfConfigPdfConfignew instancePDF yolu ayarları.
boolExportPdfAfalseArşiv PDF/A çıktısı.
boolShowColortrueMonokrom yerine renk.
boolWhiteBackgroundtrueSiyah yerine beyaz arka plan.
shortLineWidth25CAD çizgi kalınlığı.
boolShowLayoutsfalseDüzen sekmelerini render et.
boolShowModeltrueModel alanını render et.
boolCheck3DSolidtrue3D katı cisimleri işle.
boolExportAllLayoutsfalseTüm düzenleri dışa aktar, model/düzen seçimini geçersiz kılar.
boolLimitMinimumSizefalseMinimumSize'ı uygula.
intMinimumSize700Minimum çıktı boyutu piksel cinsinden.
boolLimitMaximumSizefalseMaximumSize'ı uygula.
intMaximumSize700Maksimum çıktı boyutu piksel cinsinden.
boolShowAllLayoutsDgnfalseTüm DGN düzenlerini dahil et.
boolAutomaticLayoutScalingtrueDüzenleri otomatik ölçekle.
floatPdfMargins0.5PDF kenar boşluğu inç cinsinden.
RenderQualityQualityImageLowRaster kalitesi: Low, Medium veya High.
RenderQualityQualityTextMediumMetin kalitesi: Low, Medium veya High.

E-postaYapılandırması

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

TürÖzellikVarsayılanDavranış
boolDefaultRendertrueYerel e-posta render'ı; false PDF yönlendirmesini kullanır.
PdfConfigPdfConfigyeni örnekPDF yolu ayarları.
Encoding?EmailEncodingnullİleti kodlamasını geçersiz kıl.
Encoding?SubjectEncodingnullKonu kodlamasını geçersiz kıl.
Encoding?BodyEncodingnullGövde kodlamasını geçersiz kıl.
boolSkipExternalImagesfalseUzaktan referans verilen görüntüleri yükleme. Güvenilmeyen e-posta için önerilir.
boolRemoveLastWhitePagefalseSonundaki boş sayfayı kaldır.
boolUseAntiAliasingfalseAnti-aliasing'i etkinleştir.
boolUseHighQualityRenderingfalseDaha temiz, daha yavaş renderlemeyi tercih et.
TimeSpan?TimeZoneOffsetnullTarihler için kullanılan saat dilimini geçersiz kıl.
boolForcePageSizefalseSabit sayfa boyutlarını zorla.

GörüntüYapılandırması, TiffYapılandırması ve PsdYapılandırması

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.

YapılandırmaÖzellikVarsayılanDavranış
ImageConfigMaxImagePixelSize3000Maksimum genişlik/yükseklik. 0 sınırsız anlamına gelir; 50'nin altındaki sıfır olmayan değerler yok sayılır.
ImageConfigTransparentPngtruePNG şeffaflığını koru; false beyaz arka plan kullanır.
TiffConfigek özellik yokDPI 200Sadece BaseConfig kullanır; çok sayfalı TIFF'ı destekler.
PsdConfigMaxImagePixelSize3000Aynı 0/minimum-50 doğrulaması ImageConfig gibi; varsayılan DPI 100.

DicomYapılandırması

Biçimler: DCM, IMA. Varsayılan etkin DPI: 100. DICOM eklentisi gerekir. Bu paket üzerinde DICOM dosyaları tam olarak render edilir, ancak teknik meta veriler mevcut değil — bkz. DICOM Eklentisi.

TürÖzellikVarsayılanDavranış
intHorizontalResolution100 etkinAçık yatay DPI; aksi takdirde ImageResolution, ardından 100.
intVerticalResolution100 etkinAçık dikey DPI; aksi takdirde ImageResolution, ardından 100.
intAnimationFrameDelayMs100Çok çerçeveli animasyon gecikmesi; GIF zamanlaması 10 ms birimlerini kullanır.
ushortLoopCount00 sonsuza kadar döner; pozitif değerler o sayımdan sonra durur.
DicomDisplayModeDisplayModeAnimationAndFramesAnimationOnly, FramesOnly, ya da birleştirilmiş genel bakış artı statik çerçeveler.

TxtYapılandırması

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

TürÖzellikVarsayılanDavranış
DocPaperSizePaperSizeA4Çıktı kağıt boyutu.
Encoding?FileEncodingnullnull UTF-8 kullanır.
stringFontInformation""Metin render'ı için yazı tipi bilgisi.

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

ProjeYapılandırması

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

TürÖzellikVarsayılanDavranış
boolDefaultRendertrueYerel Gantt görüntüsü; false metin tabanlı PDF yolunu kullanır.
PdfConfigPdfConfigyeni örnekPDF yolu ayarları.
boolExportPdfAtrueArşiv PDF/A çıktısı.
MppPaperSizePaperSizeLedgerProje çıktısı kağıt boyutu.
MppTimeScaleTimeScaleMonthsDays veya Months.
MppFormatPresentationFormatGanttChartGanttChart, TaskUsage, ResourceUsage, ResourceSheet, veya TaskSheet.

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

VisioYapılandırması

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

TürÖzellikVarsayılanDavranış
boolDefaultRendertrueYerel diyagram render'ı; false PDF yönlendirmesini kullanır.
PdfConfigPdfConfigyeni örnekPDF yolu ayarları.
boolExportPdfAtrueArşiv PDF/A çıktısı.

HtmlYapılandırması, EpubYapılandırması, MhtYapılandırması ve XpsYapılandırması

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

YapılandırmaBiçimlerDefaultRenderEk özellikler/davranış
HtmlConfigHTML, HTMtrueYerel render; metin tabanlı PDF arama yolu için false kullanın.
EpubConfigEPUBtrueYerel render; false PDF kullanır.
MhtConfigMHT, MHTMLtrue sınıf üzerinde; otomatik katalogda falseNormal yapılandırmasız açma, aranabilir PDF yönlendirmesini kullanır. Açıkça oluşturulmuş varsayılan örnek yerel olarak render eder.
XpsConfigXPSfalseVarsayılan olarak PDF yolunu kullanır; yerel görüntü render'ı için true ayarlayın.

Aileye göre yapılandırma örnekleri

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
    }
};

Uzantı başına seçim

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 yönlendirme → piksel‑tam yerel metin araması
    ".HTML" or ".HTM" => new HtmlConfig { DefaultRender = false },
    ".EML" or ".EMLX" or ".MSG" => new EmailConfig { DefaultRender = false },
    _ => null // formatın varsayılan config'e geri dön
};

Bu sayfa yardımcı oldu mu?