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.
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 | Özellik | Varsayılan | Davranış |
|---|---|---|---|
int | ImageResolution | 0 | 0 format varsayılanını kullanır. Geçerli açık aralık 25-300 DPI'dir; geçersiz atamalar yok sayılır. |
string | DocumentCulture | "" | Tarih ve sayılar için yerel ayar. Boş olmayan değerler kırpılır; boş atamalar yok sayılır. |
string | Password | "" | Korunan belge şifresi. DocOptions.Password burada otomatik olarak kopyalanır. |
bool | ShowUI | true | Uyumluluk özelliği; mevcut işleyici bunu tarayıcı araç çubuğunu kontrol etmek için kullanmaz. |
bool | CachePages | true | Belge oturumu için işlenmiş sayfa görüntülerini önbellekle. |
PdfConfig
Formatlar: PDF. Varsayılan DPI: 200.
| Tür | Özellik | Varsayılan | Davranış |
|---|---|---|---|
bool | DefaultRender | true | Uyumluluk anahtarı. Mevcut fabrika yerel PDF görüntüleyiciyi kullanır. |
bool | AllowSearch | false | PDF metin arama indeksini oluştur/kullan. İstekler için Arama lisans yeteneği gerekir. |
bool | AllowCopy | false | Metin seçme/kopyalama işlemlerine izin ver. |
bool | ExtractHyperlinks | false | İstemci katmanları için bağlantı dikdörtgenlerini çıkar. |
int | HyperlinksPageCount | 0 | Bağlantılar için taranan maksimum sayfa; 0 her sayfa anlamına gelir. |
bool | CompressImages | false | İşleme öncesi gömülü görüntüleri sıkıştır. |
int | CompressQuality | 100 | Sıkıştırma etkin olduğunda kullanılan JPEG kalitesi. |
bool | ResizeImages | false | İşleme öncesi gömülü görüntüleri yeniden boyutlandır. |
int | ResizeResolution | 300 | Yeniden boyutlandırılmış görüntüler için hedef DPI. |
bool | CompressFast | false | Daha hızlı, düşük kaliteli sıkıştırma yolunu tercih et. |
bool | FixInvalidImages | false | Geçersiz gömülü görüntüleri onarmayı dene. |
bool | SplitSegments | false | Arama/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 | Özellik | Varsayılan | Davranış |
|---|---|---|---|
bool | DefaultRender | true | Yerel Word render; false PDF yönlendirmesini kullanır. |
PdfConfig | PdfConfig | new instance | PDF/arama yolunda kullanılan ayarlar. |
DocPaperSize | PaperSize | A4 | Çıktı kağıt boyutu. Genişlik/yükseklik için Custom kullan. |
int | PaperWidth | 595 | Nokta cinsinden özel genişlik. |
int | PaperHeight | 841 | Nokta cinsinden özel yükseklik. |
bool | RemovePaperMargin | false | Belge sayfa kenar boşluklarını kaldır. |
bool | RenderPageColor | true | Word'ün ayarlanmış sayfa rengini koru; false beyaz sayfalar render eder. |
bool | ExportPdfA | false | PDF yolunda arşiv PDF/A kullan. |
Encoding? | FileEncoding | null | Kaynak kodlamayı geçersiz kıl. |
string | FontInfo | "" | Yazı tipi ikame bilgisi. |
string[]? | FontFolders | null | Ek yazı tipi dizinleri — belgelerin kullandığı yazı tiplerine sahip olmayan bir sunucuda faydalıdır. |
bool | AllowSearch | false | PdfConfig.AllowSearch'a delege eder. |
bool | AllowCopy | false | PdfConfig.AllowCopy'a delege eder. |
TableAutoFitBehavior | AutoFitAllTables | None | None, AutoFitToContents veya AutoFitToWindow. |
ExcelConfig
Biçimler: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. Varsayılan DPI: 200.
| Tür | Özellik | Varsayılan | Davranış |
|---|---|---|---|
bool | DefaultRender | true | Yerel sayfa render'ı; false PDF yönlendirmesini kullanır. |
PdfConfig | PdfConfig | new instance | PDF/arama yolu ayarları. |
ExcelPaperSize | PaperSize | PaperA4 | Çıktı kağıt boyutu. |
double | PaperMargins | 0.25 | Sayfa kenar boşlukları inç cinsinden. |
bool | PaperLandscape | true | Yatay sayfa render'ı. |
bool | AutoFitContents | false | Satır yüksekliği ve sütun genişliğini otomatik sığdır. |
bool | RemoveEmptyContent | true | Boş içeriği dışarıda bırakarak çıktıyı sıkılaştır. |
bool | CalculateFormula | true | Render'dan önce formülleri yeniden hesapla. |
bool | ShowRowColumnHeaders | true | Elektronik tablo başlıklarını dahil et. |
bool | ExportPdfA | false | PDF yolunda PDF/A kullan. |
bool | SplitWorksheets | false | Çalışma sayfalarını ayrı sayfa grupları olarak tut. |
bool | ShowEmptyWorkSheets | false | Boş çalışma sayfalarını dahil et. |
bool | ExportLandscape | false | Yatay dışa aktarmayı zorla. |
bool | ExportOnePagePerSheet | false | Her çalışma sayfasını tek bir çıktı sayfasına sığdır. |
bool | MemoryOptimizationPreference | true | Tepe bellek kullanımını azalt, muhtemelen biraz hız kaybı ile. |
bool | AutoTrimWorksheetRenderRange | true | Açık bir yazdırma alanı yoksa yalnızca görünen kullanılan aralığı render et. |
bool | AutoTrimPreserveExistingPrintArea | true | Otomatik kırpma sırasında çalışma kitabı tanımlı yazdırma alanlarını koru. |
string? | PrintArea | null | Örneğin "A1:Z100" gibi açık aralık. |
bool | PrintGridlines | false | Çalışma sayfası ızgaralarını yazdır. |
bool | PrintHeadings | false | Satır/sütun başlıklarını yazdır. |
List<string> | SheetNames | empty | Render'ı yalnızca adlandırılmış çalışma sayfalarına kısıtla. |
CustomStyleCell? | CustomStyles | null | İsteğe bağlı tarih/ondalık/tamsayı biçimlendirme geçersiz kılmaları. |
bool | AllowSearch | false | PdfConfig.AllowSearch'a delege eder. |
bool | AllowCopy | false | PdfConfig.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 | Özellik | Varsayılan | Davranış |
|---|---|---|---|
bool | DefaultRender | true | Yerel slayt render'ı; false PDF yönlendirmesini kullanır. |
bool | FastLoad | false | Açılışta ilk slaytı render etmemek; meta verileri kullan ve talep üzerine render et. |
PdfConfig | PdfConfig | new instance | PDF/arama davranışı ayarları. |
string | FontInfo | "" | Yazı tipi ikame bilgisi. |
string[]? | FontFolders | null | Ek yazı tipi dizinleri. |
bool | AllowSearch | false | PdfConfig.AllowSearch'a delege eder. |
bool | AllowCopy | false | PdfConfig.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 | Özellik | Varsayılan | Davranış |
|---|---|---|---|
bool | DefaultRender | true | Yerel CAD render'ı; false PDF yönlendirmesini kullanır. |
PdfConfig | PdfConfig | new instance | PDF yolu ayarları. |
bool | ExportPdfA | false | Arşiv PDF/A çıktısı. |
bool | ShowColor | true | Monokrom yerine renk. |
bool | WhiteBackground | true | Siyah yerine beyaz arka plan. |
short | LineWidth | 25 | CAD çizgi kalınlığı. |
bool | ShowLayouts | false | Düzen sekmelerini render et. |
bool | ShowModel | true | Model alanını render et. |
bool | Check3DSolid | true | 3D katı cisimleri işle. |
bool | ExportAllLayouts | false | Tüm düzenleri dışa aktar, model/düzen seçimini geçersiz kılar. |
bool | LimitMinimumSize | false | MinimumSize'ı uygula. |
int | MinimumSize | 700 | Minimum çıktı boyutu piksel cinsinden. |
bool | LimitMaximumSize | false | MaximumSize'ı uygula. |
int | MaximumSize | 700 | Maksimum çıktı boyutu piksel cinsinden. |
bool | ShowAllLayoutsDgn | false | Tüm DGN düzenlerini dahil et. |
bool | AutomaticLayoutScaling | true | Düzenleri otomatik ölçekle. |
float | PdfMargins | 0.5 | PDF kenar boşluğu inç cinsinden. |
RenderQuality | QualityImage | Low | Raster kalitesi: Low, Medium veya High. |
RenderQuality | QualityText | Medium | Metin kalitesi: Low, Medium veya High. |
E-postaYapılandırması
Biçimler: EML, EMLX, MSG. Varsayılan DPI: 200.
| Tür | Özellik | Varsayılan | Davranış |
|---|---|---|---|
bool | DefaultRender | true | Yerel e-posta render'ı; false PDF yönlendirmesini kullanır. |
PdfConfig | PdfConfig | yeni örnek | PDF yolu ayarları. |
Encoding? | EmailEncoding | null | İleti kodlamasını geçersiz kıl. |
Encoding? | SubjectEncoding | null | Konu kodlamasını geçersiz kıl. |
Encoding? | BodyEncoding | null | Gövde kodlamasını geçersiz kıl. |
bool | SkipExternalImages | false | Uzaktan referans verilen görüntüleri yükleme. Güvenilmeyen e-posta için önerilir. |
bool | RemoveLastWhitePage | false | Sonundaki boş sayfayı kaldır. |
bool | UseAntiAliasing | false | Anti-aliasing'i etkinleştir. |
bool | UseHighQualityRendering | false | Daha temiz, daha yavaş renderlemeyi tercih et. |
TimeSpan? | TimeZoneOffset | null | Tarihler için kullanılan saat dilimini geçersiz kıl. |
bool | ForcePageSize | false | Sabit 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 | Özellik | Varsayılan | Davranış |
|---|---|---|---|
ImageConfig | MaxImagePixelSize | 3000 | Maksimum 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. |
ImageConfig | TransparentPng | true | PNG şeffaflığını koru; false beyaz arka plan kullanır. |
TiffConfig | ek özellik yok | DPI 200 | Sadece BaseConfig kullanır; çok sayfalı TIFF'ı destekler. |
PsdConfig | MaxImagePixelSize | 3000 | Aynı 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 | Özellik | Varsayılan | Davranış |
|---|---|---|---|
int | HorizontalResolution | 100 etkin | Açık yatay DPI; aksi takdirde ImageResolution, ardından 100. |
int | VerticalResolution | 100 etkin | Açık dikey DPI; aksi takdirde ImageResolution, ardından 100. |
int | AnimationFrameDelayMs | 100 | Çok çerçeveli animasyon gecikmesi; GIF zamanlaması 10 ms birimlerini kullanır. |
ushort | LoopCount | 0 | 0 sonsuza kadar döner; pozitif değerler o sayımdan sonra durur. |
DicomDisplayMode | DisplayMode | AnimationAndFrames | AnimationOnly, FramesOnly, ya da birleştirilmiş genel bakış artı statik çerçeveler. |
TxtYapılandırması
Biçim: TXT. Varsayılan DPI: 200.
| Tür | Özellik | Varsayılan | Davranış |
|---|---|---|---|
DocPaperSize | PaperSize | A4 | Çıktı kağıt boyutu. |
Encoding? | FileEncoding | null | null UTF-8 kullanır. |
string | FontInformation | "" | 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 | Özellik | Varsayılan | Davranış |
|---|---|---|---|
bool | DefaultRender | true | Yerel Gantt görüntüsü; false metin tabanlı PDF yolunu kullanır. |
PdfConfig | PdfConfig | yeni örnek | PDF yolu ayarları. |
bool | ExportPdfA | true | Arşiv PDF/A çıktısı. |
MppPaperSize | PaperSize | Ledger | Proje çıktısı kağıt boyutu. |
MppTimeScale | TimeScale | Months | Days veya Months. |
MppFormat | PresentationFormat | GanttChart | GanttChart, 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 | Özellik | Varsayılan | Davranış |
|---|---|---|---|
bool | DefaultRender | true | Yerel diyagram render'ı; false PDF yönlendirmesini kullanır. |
PdfConfig | PdfConfig | yeni örnek | PDF yolu ayarları. |
bool | ExportPdfA | true | Arş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ırma | Biçimler | DefaultRender | Ek özellikler/davranış |
|---|---|---|---|
HtmlConfig | HTML, HTM | true | Yerel render; metin tabanlı PDF arama yolu için false kullanın. |
EpubConfig | EPUB | true | Yerel render; false PDF kullanır. |
MhtConfig | MHT, MHTML | true sınıf üzerinde; otomatik katalogda false | Normal yapılandırmasız açma, aranabilir PDF yönlendirmesini kullanır. Açıkça oluşturulmuş varsayılan örnek yerel olarak render eder. |
XpsConfig | XPS | false | Varsayılan olarak PDF yolunu kullanır; yerel görüntü render'ı için true ayarlayın. |
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[] { 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
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?