תצורות פורמט

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

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

מרחב השמות היחיד הזה הוא חדש. ספריית .NET Standard הקודמת פיזרה סוגים אלה על פני Doconut.Configs, Doconut.Configs.View ו-Doconut.Models. השמות הסוגים לא השתנו — ברוב הקבצים העריכה כולה היא מחיקת שני שורות using. ראו את מדריך ההגירה.

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ספריות גופנים נוספות — שימושיות בשרת שאין בו את הגופנים שהמסמכים משתמשים בהם.
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.

התקן את הגופנים שהמצגות משתמשות בהם על השרת, או הפנה את FontFolders לתיקייה שמכילה אותם. גופנים חסרים מוחלפים ללא כל שגיאה.

תצורת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. בחבילה זו קבצי DICOM מוצגים במלואם, אך מטא‑נתונים טכניים אינם זמינים — ראה תוסף 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תמונה מקומית של גאנט; 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

כל ארבעת ההגדרות משתמשות ב‑200 DPI ברירת מחדל ומחשפות 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 = 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
    }
};

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

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 // חזור לתצורת ברירת המחדל של הפורמט
};

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