תצורות פורמט
אפשרויות רינדור מלאות לכל פורמט
כל מסמך נפתח עם יישום של BaseConfig. העבירו אחד ל-OpenDocumentAsync או תנו לקטלוג הפורמט ליצור את ברירת המחדל שלו. כל המחלקות למטה נמצאות במרחב השמות Doconut.
מרחב השמות היחיד הזה הוא חדש. ספריית .NET Standard הקודמת פיזרה סוגים אלה על פני Doconut.Configs, Doconut.Configs.View ו-Doconut.Models. השמות הסוגים לא השתנו — ברוב הקבצים העריכה כולה היא מחיקת שני שורות using. ראו את מדריך ההגירה.
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
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
int | ImageResolution | 0 | 0 משתמש בברירת המחדל של הפורמט. טווח תקף מפורש הוא 25‑300 DPI; הקצאות לא חוקיות מתעלמות. |
string | DocumentCulture | "" | מיקום לתאריכים ולמספרים. ערכים שאינם ריקים נחתכים; הקצאות ריקות מתעלמות. |
string | Password | "" | סיסמת מסמך מוגן. DocOptions.Password מועתקת כאן אוטומטית. |
bool | ShowUI | true | מאפיין תאימות; המעבד הנוכחי אינו משתמש בו לשליטה בסרגל הכלים של הדפדפן. |
bool | CachePages | true | שמירת במטמון של תמונות דפים מרונדרים עבור סשן המסמך. |
PdfConfig
פורמטים: PDF. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | מתג תאימות. המפעל הנוכחי משתמש במציג PDF המקורי. |
bool | AllowSearch | false | בנייה/שימוש באינדקס חיפוש טקסט ב‑PDF. דורש את יכולת הרישיון Search לבקשות. |
bool | AllowCopy | false | מתן אפשרות לבחירת/העתקת טקסט. |
bool | ExtractHyperlinks | false | חילוץ מלבני קישורים עבור שכבות לקוח. |
int | HyperlinksPageCount | 0 | מספר מקסימלי של דפים שנסרקים לקישורים; 0 משמעותו כל הדף. |
bool | CompressImages | false | דחיסת תמונות משובצות לפני הרינדור. |
int | CompressQuality | 100 | איכות JPEG המשמשת כאשר הדחיסה מופעלת. |
bool | ResizeImages | false | שינוי גודל של תמונות משובצות לפני הרינדור. |
int | ResizeResolution | 300 | DPI יעד לתמונות משוכתבות. |
bool | CompressFast | false | העדפת נתיב דחיסה מהיר יותר, באיכות נמוכה יותר. |
bool | FixInvalidImages | false | ניסיון לתקן תמונות משובצות שגויות. |
bool | SplitSegments | false | חיבור מחדש של מילים שמפוצלות על פני קטעי שורה לשיפור חיפוש/העתקה. |
showHyperlinks ב-ViewerConfig שולט בשכבת הלקוח, בעוד ExtractHyperlinks שולט בחילוץ השרת. אפשרו את שניהם.
WordConfig
פורמטים: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, XML. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | רינדור Word מקורי; false משתמש בהפנייה ל‑PDF. |
PdfConfig | PdfConfig | new instance | הגדרות המשמשות בנתיב PDF/חיפוש. |
DocPaperSize | PaperSize | A4 | גודל נייר פלט. השתמשו ב-Custom עם רוחב/גובה. |
int | PaperWidth | 595 | רוחב מותאם אישית בנקודות. |
int | PaperHeight | 841 | גובה מותאם אישית בנקודות. |
bool | RemovePaperMargin | false | הסרת שוליים של דפי המסמך. |
bool | RenderPageColor | true | שמירת צבע העמוד המוגדר ב‑Word; false מציג דפים לבנים. |
bool | ExportPdfA | false | שימוש ב‑PDF/A ארכיב בנתיב PDF. |
Encoding? | FileEncoding | null | דריסת קידוד המקור. |
string | FontInfo | "" | מידע על החלפת גופנים. |
string[]? | FontFolders | null | ספריות גופנים נוספות — שימושיות בשרת שאין בו את הגופנים שהמסמכים משתמשים בהם. |
bool | AllowSearch | false | מועבר ל‑PdfConfig.AllowSearch. |
bool | AllowCopy | false | מועבר ל‑PdfConfig.AllowCopy. |
TableAutoFitBehavior | AutoFitAllTables | None | None, AutoFitToContents, או AutoFitToWindow. |
תצורתExcel
פורמטים: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | רינדור גיליון מקורי; false משתמש בהפנייה ל-PDF. |
PdfConfig | PdfConfig | מופע חדש | הגדרות לנתיב PDF/חיפוש. |
ExcelPaperSize | PaperSize | PaperA4 | גודל נייר פלט. |
double | PaperMargins | 0.25 | שוליים בעמוד באינצ'ים. |
bool | PaperLandscape | true | רינדור גיליון באופקית. |
bool | AutoFitContents | false | התאמת גובה שורות ורוחב עמודות אוטומטית. |
bool | RemoveEmptyContent | true | צמצום פלט על ידי הוצאת תוכן ריק. |
bool | CalculateFormula | true | חישוב מחדש של נוסחאות לפני הרינדור. |
bool | ShowRowColumnHeaders | true | הכללת כותרות גיליון. |
bool | ExportPdfA | false | שימוש ב-PDF/A בנתיב ה-PDF. |
bool | SplitWorksheets | false | שמירת גיליונות כקבוצות עמודים נפרדות. |
bool | ShowEmptyWorkSheets | false | הכללת גיליונות ריקים. |
bool | ExportLandscape | false | אילוץ ייצוא באופקית. |
bool | ExportOnePagePerSheet | false | התאמת כל גיליון לעמוד פלט אחד. |
bool | MemoryOptimizationPreference | true | הפחתת זיכרון קצה, ייתכן במחיר של מהירות. |
bool | AutoTrimWorksheetRenderRange | true | רינדור רק של הטווח בשימוש הגלוי כאשר אין אזור הדפסה מפורש. |
bool | AutoTrimPreserveExistingPrintArea | true | שמירת אזורי הדפסה שהוגדרו במחברת במהלך קיצוץ אוטומטי. |
string? | PrintArea | null | טווח מפורש כגון "A1:Z100". |
bool | PrintGridlines | false | הדפסת קווי רשת של הגיליון. |
bool | PrintHeadings | false | הדפסת כותרות שורה/עמודה. |
List<string> | SheetNames | empty | הגבלת הרינדור לגיליונות בשם. |
CustomStyleCell? | CustomStyles | null | החלפת פורמט תאריך/דצימלי/שלם אופציונלית. |
bool | AllowSearch | false | מועבר ל-PdfConfig.AllowSearch. |
bool | AllowCopy | false | מועבר ל-PdfConfig.AllowCopy. |
CustomStyleCell חושף את CustomStyleDateTime, CustomStyleNumberDecimal, ו-CustomStyleNumberInteger, כולם מחרוזות ניתנות לאפס.
new ExcelConfig() מגדיר את SplitWorksheets ל-false; פתיחת קובץ Excel ללא תצורה מפורשת משתמשת במאגר הפורמטים, שמגדיר אותו ל-true.
תצורתPpt
פורמטים: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | רינדור שקופית מקורי; false משתמש בהפנייה ל-PDF. |
bool | FastLoad | false | הימנעות מרינדור השקופית הראשונה בעת פתיחה; שימוש במטא-דאטה ורינדור לפי דרישה. |
PdfConfig | PdfConfig | מופע חדש | הגדרות להתנהגות PDF/חיפוש. |
string | FontInfo | "" | מידע על החלפת גופנים. |
string[]? | FontFolders | null | ספריות גופנים נוספות. |
bool | AllowSearch | false | מועבר ל-PdfConfig.AllowSearch. |
bool | AllowCopy | false | מועבר ל-PdfConfig.AllowCopy. |
התקן את הגופנים שהמצגות משתמשות בהם על השרת, או הפנה את FontFolders לתיקייה שמכילה אותם. גופנים חסרים מוחלפים ללא כל שגיאה.
תצורתCad
פורמטים: DWG, DXF, DGN. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | רינדור CAD מקורי; false משתמש בהפנייה ל-PDF. |
PdfConfig | PdfConfig | מופע חדש | הגדרות נתיב PDF. |
bool | ExportPdfA | false | פלט PDF/A ארכיוני. |
bool | ShowColor | true | צבע במקום שחור-לבן. |
bool | WhiteBackground | true | רקע לבן במקום שחור. |
short | LineWidth | 25 | רוחב קו CAD. |
bool | ShowLayouts | false | רינדור לשוניות פריסה. |
bool | ShowModel | true | רינדור מרחב מודל. |
bool | Check3DSolid | true | עיבוד מוצקים תלת-ממדיים. |
bool | ExportAllLayouts | false | ייצוא כל הפריסות, תוך דריסת בחירת מודל/פריסה. |
bool | LimitMinimumSize | false | החלת MinimumSize. |
int | MinimumSize | 700 | גודל פלט מינימלי בפיקסלים. |
bool | LimitMaximumSize | false | החלת MaximumSize. |
int | MaximumSize | 700 | גודל פלט מרבי בפיקסלים. |
bool | ShowAllLayoutsDgn | false | הכללת כל פריסות DGN. |
bool | AutomaticLayoutScaling | true | קנה מידה אוטומטי של פריסות. |
float | PdfMargins | 0.5 | שוליים של PDF באינצ'ים. |
RenderQuality | QualityImage | Low | איכות רסטר: Low, Medium, או High. |
RenderQuality | QualityText | Medium | איכות טקסט: Low, Medium, או High. |
תצורת דוא"ל
פורמטים: EML, EMLX, MSG. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | הצגה מקומית של דוא"ל; false משתמש בהפנייה ל‑PDF. |
PdfConfig | PdfConfig | מופע חדש | הגדרות נתיב PDF. |
Encoding? | EmailEncoding | null | עקיפת קידוד ההודעה. |
Encoding? | SubjectEncoding | null | עקיפת קידוד הנושא. |
Encoding? | BodyEncoding | null | עקיפת קידוד הגוף. |
bool | SkipExternalImages | false | אל תטען תמונות שמקושרות מרחוק. מומלץ עבור דוא"ל לא מהימן. |
bool | RemoveLastWhitePage | false | הסר דף ריק סופי. |
bool | UseAntiAliasing | false | הפעל אנטי‑אליאסינג. |
bool | UseHighQualityRendering | false | העדף רינדור נקי יותר, איטי יותר. |
TimeSpan? | TimeZoneOffset | null | עקיפת אזור הזמן המשמש לתאריכים. |
bool | ForcePageSize | false | הכרז ממדים קבועים לעמוד. |
ImageConfig, TiffConfig ו-PsdConfig
ImageConfig תומך ב‑JPG, JPEG, JPE, PNG, BMP, GIF, ICO, EPS, TGA, WEBP, CDR, CMX, DNG, EMF, WMF, AVIF ו‑SVG. ברירת המחדל של DPI היא 100.
| תצורה | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
ImageConfig | MaxImagePixelSize | 3000 | רוחב/גובה מרבי. 0 משמעותו ללא הגבלה; ערכים שונים מאפס מתחת ל‑50 מתעלמים מהם. |
ImageConfig | TransparentPng | true | שמור שקיפות PNG; false משתמש ברקע לבן. |
TiffConfig | אין מאפיינים נוספים | DPI 200 | משתמש רק ב‑BaseConfig; תומך ב‑TIFF מרובה עמודים. |
PsdConfig | MaxImagePixelSize | 3000 | אותה בדיקת 0/מינימום‑50 כמו ImageConfig; ברירת המחדל של DPI היא 100. |
DicomConfig
פורמטים: DCM, IMA. DPI אפקטיבי ברירת מחדל: 100. דורש את תוסף DICOM. בחבילה זו קבצי DICOM מוצגים במלואם, אך מטא‑נתונים טכניים אינם זמינים — ראה תוסף DICOM.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
int | HorizontalResolution | 100 אפקטיבי | DPI אופקי מפורש; אחרת ImageResolution, ואז 100. |
int | VerticalResolution | 100 אפקטיבי | DPI אנכי מפורש; אחרת ImageResolution, ואז 100. |
int | AnimationFrameDelayMs | 100 | השהיית אנימציה מרובת מסגרות; תזמון GIF משתמש ביחידות של 10 מ״ש. |
ushort | LoopCount | 0 | 0 חוזר לנצח; ערכים חיוביים עוצרים אחרי ספירה זו. |
DicomDisplayMode | DisplayMode | AnimationAndFrames | AnimationOnly, FramesOnly, או סקירה משולבת עם מסגרות סטטיות. |
TxtConfig
פורמט: TXT. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
DocPaperSize | PaperSize | A4 | גודל נייר פלט. |
Encoding? | FileEncoding | null | null משתמש ב‑UTF-8. |
string | FontInformation | "" | מידע גופנים עבור רינדור טקסט. |
השתמש ב‑WordConfig כאשר טקסט פשוט דורש התנהגות פריסת עמוד עשירה יותר.
ProjectConfig
פורמטים: MPP, MPPX, MPX. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | תמונה מקומית של גאנט; false משתמש בנתיב PDF מבוסס טקסט. |
PdfConfig | PdfConfig | מופע חדש | הגדרות נתיב PDF. |
bool | ExportPdfA | true | פלט PDF/A ארכיוני. |
MppPaperSize | PaperSize | Ledger | גודל נייר פלט של הפרויקט. |
MppTimeScale | TimeScale | Months | Days או Months. |
MppFormat | PresentationFormat | GanttChart | GanttChart, TaskUsage, ResourceUsage, ResourceSheet, או TaskSheet. |
לחיפוש מדויק לפי קואורדינטות טקסט, השתמש ב‑DefaultRender = false.
VisioConfig
פורמטים: VSD, VSDX, VSS, VSSX, VST, VSTX, VDX, VSX, VSDM. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | הצגת דיאגרמה מקומית; false משתמש בהפנייה ל‑PDF. |
PdfConfig | PdfConfig | מופע חדש | הגדרות נתיב PDF. |
bool | ExportPdfA | true | פלט PDF/A ארכיוני. |
HtmlConfig, EpubConfig, MhtConfig ו-XpsConfig
כל ארבעת ההגדרות משתמשות ב‑200 DPI ברירת מחדל ומחשפות PdfConfig מקונן.
| תצורה | פורמטים | DefaultRender | מאפיינים/התנהגות נוספים |
|---|---|---|---|
HtmlConfig | HTML, HTM | true | הצגה מקומית; השתמש ב‑false לנתיב חיפוש PDF מבוסס טקסט. |
EpubConfig | EPUB | true | הצגה מקומית; false משתמש ב‑PDF. |
MhtConfig | MHT, MHTML | true על המחלקה; false בקטלוג האוטומטי | פתיחה רגילה ללא תצורה משתמשת בהפנייה ל‑PDF הניתן לחיפוש. מופע ברירת מחדל שנבנה במפורש מציג באופן מקומי. |
XpsConfig | XPS | false | משתמש בנתיב PDF כברירת מחדל; הגדר true להצגת תמונה מקומית. |
דוגמאות תצורה לפי משפחה
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
}
};בחירה לפי סיומת
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 // חזור לתצורת ברירת המחדל של הפורמט
};האם דף זה היה מועיל?