תצורות פורמט

אפשרויות רינדור מלאות לכל פורמט

כל מסמך נפתח עם מימוש של BaseConfig. העבירו אחד ל-OpenDocumentAsync או תנו לקטלוג הפורמט ליצור ברירת מחדל משלו. כל המחלקות שלהלן נמצאות במרחב השמות Doconut.

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

ירושה והגדרות PDF מקוננות

כל פורמט יורש את חמשת המאפיינים BaseConfig. פורמטים שיכולים להפנות דרך PDF מציגים PdfConfig מקונן. ב-WordConfig, ExcelConfig ו-PptConfig, AllowSearch ו-AllowCopy הם מאפיינים נוחות שקוראים וכותבים את PdfConfig המקונן.

DefaultRender = true בוחר את מנגנון הרינדור של הפורמט הטבעי. בפורמטים עם הפנייה ל-PDF, false ממיר תחילה ל-PDF בזיכרון ולאחר מכן משתמש במציג ה-PDF. נתיב זה לעיתים קרובות שימושי לחיפוש לפי קואורדינטות טקסט, אך דורש המרה נוספת.

אלא אם צוין אחרת, הטבלאות מציגות ערכי ברירת מחדל של קונסטרוקטורים/מאפיינים. קטלוג הפורמט האוטומטי מתעלם במכוון משניים מהם: הוא יוצר ExcelConfig עם SplitWorksheets = true, ו-MhtConfig עם DefaultRender = false.

BaseConfig

סוגמאפייןברירת מחדלהתנהגות
intImageResolution00 משתמש בברירת המחדל של הפורמט. טווח תקף מפורש הוא 25-300 DPI; הקצאות לא תקינות מתעלמים.
stringDocumentCulture""אזור עבור תאריכים ומספרים. ערכים שאינם ריקים נחתכים; הקצאות ריקות מתעלמים.
stringPassword""סיסמת מסמך מוגן. DocOptions.Password מועתקת לכאן באופן אוטומטי.
boolShowUItrueמאפיין התאמה; המנוע הנוכחי אינו משתמש בו לשליטה בסרגל הכלים של הדפדפן.
boolCachePagestrueמאגר תמונות דפים מרונדרים עבור סשן המסמך.

PdfConfig

פורמטים: PDF. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueמתג התאמה. המפעל הנוכחי משתמש במציג ה-PDF הטבעי.
boolAllowSearchfalseבנה/השתמש באינדקס חיפוש טקסט ב-PDF. דורש את יכולת הרישיון Search לבקשות.
boolAllowCopyfalseמאפשר פעולות בחירת/העתקת טקסט.
boolExtractHyperlinksfalseמחלץ ריבועי קישורים עבור שכבות לקוח.
intHyperlinksPageCount0מספר מקסימלי של דפים שנסרקים לקישורים; 0 משמעותו כל הדף.
boolCompressImagesfalseדוחס תמונות משובצות לפני הרינדור.
intCompressQuality100איכות JPEG המשמשת כאשר הדחיסה מופעלת.
boolResizeImagesfalseשנה גודל של תמונות משובצות לפני הרינדור.
intResizeResolution300DPI יעד לתמונות משוכתבות.
boolCompressFastfalseהעדף את נתיב הדחיסה המהיר, באיכות נמוכה יותר.
boolFixInvalidImagesfalseנסה לתקן תמונות משובצות לא תקינות.
boolSplitSegmentsfalseאחד מילים שנפצלות על פני קטעי שורה כדי לשפר חיפוש/העתקה.

showHyperlinks ב-ViewerConfig שולט בשכבת הלקוח, בעוד ExtractHyperlinks שולט בחילוץ בצד השרת. אפשר לשניהם.

WordConfig

פורמטים: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, XML. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueרינדור Word טבעי; false משתמש בהפנייה ל-PDF.
PdfConfigPdfConfignew instanceהגדרות המשמשות בנתיב PDF/חיפוש.
DocPaperSizePaperSizeA4גודל נייר פלט. השתמש ב-Custom עם רוחב/גובה.
intPaperWidth595רוחב מותאם אישית בנקודות.
intPaperHeight841גובה מותאם אישית בנקודות.
boolRemovePaperMarginfalseהסר שוליים של דפי המסמך.
boolRenderPageColortrueשמר את צבע העמוד המוגדר ב-Word; false מציג דפים לבנים.
boolExportPdfAfalseהשתמש ב-PDF/A ארכיוני בנתיב ה-PDF.
Encoding?FileEncodingnullעקוף קידוד מקור.
stringFontInfo""מידע על החלפת גופנים.
string[]?FontFoldersnullספריות גופנים נוספות, במיוחד שימושיות ב-Linux/מכולות.
boolAllowSearchfalseמופנה ל-PdfConfig.AllowSearch.
boolAllowCopyfalseמופנה ל-PdfConfig.AllowCopy.
TableAutoFitBehaviorAutoFitAllTablesNoneNone, AutoFitToContents, או AutoFitToWindow.

תצורת Excel

פורמטים: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueהצגת גיליון מקומית; false משתמש בהפנייה ל‑PDF.
PdfConfigPdfConfigמופע חדשהגדרות לנתיב PDF/חיפוש.
ExcelPaperSizePaperSizePaperA4גודל נייר הפלט.
doublePaperMargins0.25שולשי עמוד באינצ'ים.
boolPaperLandscapetrueהצגת גיליון במצב אופקי.
boolAutoFitContentsfalseהתאמה אוטומטית של גובה השורות ורוחב העמודות.
boolRemoveEmptyContenttrueצמצום הפלט על ידי הוצאת תוכן ריק.
boolCalculateFormulatrueחישוב מחדש של נוסחאות לפני ההצגה.
boolShowRowColumnHeaderstrueהכללת כותרות הגיליון.
boolExportPdfAfalseשימוש ב‑PDF/A בנתיב ה‑PDF.
boolSplitWorksheetsfalseשמירת גיליונות כקבוצות עמודים נפרדות.
boolShowEmptyWorkSheetsfalseהכללת גיליונות ריקים.
boolExportLandscapefalseאילוץ יצוא במצב אופקי.
boolExportOnePagePerSheetfalseהתאמת כל גיליון לעמוד פלט אחד.
boolMemoryOptimizationPreferencetrueהפחתת זיכרון קצה, יתכן במחיר של ירידה קלה במהירות.
boolAutoTrimWorksheetRenderRangetrueהצגת רק את הטווח המשמש הגלוי כאשר אין תחום הדפסה מפורש.
boolAutoTrimPreserveExistingPrintAreatrueשמירת תחומי הדפסה שהוגדרו בחוברת העבודה במהלך חיתוך אוטומטי.
string?PrintAreanullטווח מפורש כגון "A1:Z100".
boolPrintGridlinesfalseהדפסת קווי רשת של הגיליון.
boolPrintHeadingsfalseהדפסת כותרות שורות/עמודות.
List<string>SheetNamesemptyהגבלת ההצגה לגיליונות בעלי שם.
CustomStyleCell?CustomStylesnullשכתוב פורמט תאריך/דצימלי/שלם אופציונלי.
boolAllowSearchfalseמועבר ל‑PdfConfig.AllowSearch.
boolAllowCopyfalseמועבר ל‑PdfConfig.AllowCopy.

CustomStyleCell חשוף את CustomStyleDateTime, CustomStyleNumberDecimal ו‑CustomStyleNumberInteger, כולם מחרוזות ניתנות לאפס.

new ExcelConfig() מגדיר את SplitWorksheets לfalse; פתיחת קובץ Excel ללא תצורה מפורשת משתמשת בקטלוג הפורמטים, שמגדיר אותו לtrue.

תצורת PPT

פורמטים: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueהצגת שקופית מקומית; false משתמש בהפנייה ל‑PDF.
boolFastLoadfalseהימנעות מהצגת השקופית הראשונה בעת הפתיחה; שימוש במטא‑נתונים והצגה לפי דרישה.
PdfConfigPdfConfigמופע חדשהגדרות להתנהגות PDF/חיפוש.
stringFontInfo""מידע על החלפת גופנים.
string[]?FontFoldersnullספריות גופנים נוספות.
boolAllowSearchfalseמועבר ל‑PdfConfig.AllowSearch.
boolAllowCopyfalseמועבר ל‑PdfConfig.AllowCopy.

הדפים מצוירים עם הגופנים המותקנים בשרת. ב‑Linux, התקינו את הגופנים שהמצגות משתמשות בהם או הפנו את FontFolders אליהם: גופן חסר מוחלף ללא שגיאה, ולכן שבירות שורה יכולות להיות שונות מ‑Windows. fonts-liberation, fonts-crosextra-carlito ו‑fonts-crosextra-caladea מספקים תחליפים תואמי‑מטריקה לגופנים נפוצים ב‑Windows. Linux צריך רק את libfontconfig1 (libgdiplus אינו נדרש).

תצורת CAD

פורמטים: DWG, DXF, DGN. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueהצגת CAD מקומית; false משתמש בהפנייה ל‑PDF.
PdfConfigPdfConfigמופע חדשהגדרות נתיב PDF.
boolExportPdfAfalseפלט PDF/A ארכיוני.
boolShowColortrueצבע במקום שחור‑לבן.
boolWhiteBackgroundtrueרקע לבן במקום שחור.
shortLineWidth25רוחב קו CAD.
boolShowLayoutsfalseהצגת לשוניות פריסה.
boolShowModeltrueהצגת מרחב מודל.
boolCheck3DSolidtrueעיבוד מוצקים תלת‑ממדיים.
boolExportAllLayoutsfalseייצוא כל הפריסות, תוך התעלמות מבחירת מודל/פריסה.
boolLimitMinimumSizefalseהחלת MinimumSize.
intMinimumSize700גודל פלט מינימלי בפיקסלים.
boolLimitMaximumSizefalseהחלת MaximumSize.
intMaximumSize700גודל פלט מרבי בפיקסלים.
boolShowAllLayoutsDgnfalseהכללת כל פריסות DGN.
boolAutomaticLayoutScalingtrueקנה מידה אוטומטי של פריסות.
floatPdfMargins0.5שוליים של PDF באינצ'ים.
RenderQualityQualityImageLowאיכות רסטר: Low, Medium או High.
RenderQualityQualityTextMediumאיכות טקסט: Low, Medium או High.

תצורת דוא"ל

פורמטים: EML, EMLX, MSG. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueהצגה מקומית של אימייל; false משתמשת בהפניה ל-PDF.
PdfConfigPdfConfigמופע חדשהגדרות נתיב PDF.
Encoding?EmailEncodingnullעקיפת קידוד ההודעה.
Encoding?SubjectEncodingnullעקיפת קידוד הנושא.
Encoding?BodyEncodingnullעקיפת קידוד הגוף.
boolSkipExternalImagesfalseאל תטען תמונות שמופנות מרחוק. מומלץ עבור אימייל לא מהימן.
boolRemoveLastWhitePagefalseהסר דף ריק סופי.
boolUseAntiAliasingfalseהפעל אנטי-אליאסינג.
boolUseHighQualityRenderingfalseהעדף רינדור נקי יותר, איטי יותר.
TimeSpan?TimeZoneOffsetnullעקיפת אזור הזמן המשמש לתאריכים.
boolForcePageSizefalseהכרח ממדים קבועים לדף.

ImageConfig, TiffConfig, ו-PsdConfig

ImageConfig מכסה JPG, JPEG, JPE, PNG, BMP, GIF, ICO, EPS, TGA, WEBP, CDR, CMX, DNG, EMF, WMF, AVIF, ו-SVG. DPI ברירת המחדל שלו הוא 100.

תצורהמאפייןברירת מחדלהתנהגות
ImageConfigMaxImagePixelSize3000רוחב/גובה מרבי. 0 משמעותו ללא הגבלה; ערכים שונים מאפס מתחת ל-50 מתעלמים.
ImageConfigTransparentPngtrueשמור על שקיפות PNG; false משתמש ברקע לבן.
TiffConfigאין מאפיינים נוספיםDPI 200משתמש רק ב-BaseConfig; תומך ב-TIFF מרובה דפים.
PsdConfigMaxImagePixelSize3000אותה 0/אימות מינימום-50 כמו ImageConfig; DPI ברירת המחדל הוא 100.

DicomConfig

פורמטים: DCM, IMA. DPI אפקטיבי ברירת מחדל: 100. דורש את תוסף DICOM.

סוגמאפייןברירת מחדלהתנהגות
intHorizontalResolution100 אפקטיביDPI אופקי מפורש; אחרת ImageResolution, ואז 100.
intVerticalResolution100 אפקטיביDPI אנכי מפורש; אחרת ImageResolution, ואז 100.
intAnimationFrameDelayMs100השהיית אנימציה מרובת פריימים; תזמון GIF משתמש ביחידות של 10 מ״ש.
ushortLoopCount00 חוזר לנצח; ערכים חיוביים נעצרים לאחר ספירה זו.
DicomDisplayModeDisplayModeAnimationAndFramesAnimationOnly, FramesOnly, או תצוגה משולבת עם פריימים סטטיים.

TxtConfig

פורמט: TXT. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
DocPaperSizePaperSizeA4גודל נייר פלט.
Encoding?FileEncodingnullnull משתמש ב-UTF-8.
stringFontInformation""מידע גופן עבור רינדור טקסט.

השתמש ב-WordConfig כאשר טקסט פשוט דורש התנהגות פריסת עמוד עשירה יותר.

ProjectConfig

פורמטים: MPP, MPPX, MPX. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueתמונה מקומית של Gantt; false משתמשת בנתיב PDF מבוסס טקסט.
PdfConfigPdfConfigמופע חדשהגדרות נתיב PDF.
boolExportPdfAtrueפלט PDF/A ארכיוני.
MppPaperSizePaperSizeLedgerגודל נייר פלט של הפרויקט.
MppTimeScaleTimeScaleMonthsDays או Months.
MppFormatPresentationFormatGanttChartGanttChart, TaskUsage, ResourceUsage, ResourceSheet, או TaskSheet.

לחיפוש מדויק לפי קואורדינטות טקסט, השתמש ב-DefaultRender = false.

VisioConfig

פורמטים: VSD, VSDX, VSS, VSSX, VST, VSTX, VDX, VSX, VSDM. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueרינדור תרשים מקורי; false משתמש בהפניה ל-PDF.
PdfConfigPdfConfigמופע חדשהגדרות נתיב PDF.
boolExportPdfAtrueפלט PDF/A ארכיוני.

HtmlConfig, EpubConfig, MhtConfig, ו-XpsConfig

כל הארבעה משתמשים ב-DPI של 200 כברירת מחדל ומחשפים PdfConfig מקונן.

תצורהפורמטיםDefaultRenderמאפיינים/התנהגות נוספים
HtmlConfigHTML, HTMtrueרינדור מקורי; השתמש ב-false בשביל נתיב חיפוש PDF מבוסס טקסט.
EpubConfigEPUBtrueרינדור מקורי; false משתמש ב-PDF.
MhtConfigMHT, MHTMLtrue במחלקה; false בקטלוג האוטומטיהפתיחה הרגילה ללא תצורה משתמשת בהפניה ל-PDF שניתן לחיפוש. מופע ברירת מחדל שנבנה במפורש רינדור מקורי.
XpsConfigXPSfalseמשתמש בנתיב PDF כברירת מחדל; הגדר true לרינדור תמונה מקורי.

דוגמאות תצורה לפי משפחה

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

בחירה לפי סיומת

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 → חיפוש טקסט מקורי מדויק בפיקסלים
    ".HTML" or ".HTM" => new HtmlConfig { DefaultRender = false },
    ".EML" or ".EMLX" or ".MSG" => new EmailConfig { DefaultRender = false },
    _ => null // חזור לתצורת ברירת המחדל של הפורמט
};

האם דף זה היה מועיל?