תצורות פורמט
אפשרויות רינדור מלאות לכל פורמט
כל מסמך נפתח עם מימוש של BaseConfig. ניתן להעביר אחד ל‑OpenDocumentAsync (או OpenDocument) או לאפשר לקטלוג הפורמט ליצור את ברירת המחדל שלו. כל המחלקות שלהלן נמצאות במרחב השמות Doconut.
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 | ריק | הגבלת ההצגה לגיליונות בעלי שם. |
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 לתיקייה שמכילה אותם. ל‑Windows Server ללא Office יש פחות גופנים משמעותית ממחשב פיתוח, והגופנים החסרים מוחלפים ללא שגיאה.
תצורת‑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. |
EmailConfig
פורמטים: 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 משמעותו ללא הגבלה; ערכים שונים מ‑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 | תמונת Gantt מקומית; 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 | false משתמש בנתיב PDF כברירת מחדל; קבע true לרינדור תמונה מקורי. |
דוגמאות קונפיגורציה לפי משפחה
BaseConfig[] configs =
{
new PdfConfig
{
AllowSearch = true,
ExtractHyperlinks = true,
HyperlinksPageCount = 0
},
new WordConfig
{
PaperSize = DocPaperSize.A4,
RemovePaperMargin = false,
FontFolders = new[] { HostingEnvironment.MapPath("~/App_Data/Fonts") },
AllowSearch = true
},
new ExcelConfig
{
PaperLandscape = true,
AutoFitContents = true,
CalculateFormula = true,
SplitWorksheets = false,
PrintGridlines = false
},
new PptConfig
{
FastLoad = true,
FontFolders = new[] { HostingEnvironment.MapPath("~/App_Data/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)
{
switch (extUpper)
{
case ".DOC": case ".DOCX": case ".DOT": case ".DOTX": case ".ODT":
return new WordConfig
{
AutoFitAllTables = WordConfig.TableAutoFitBehavior.AutoFitToWindow,
PaperSize = DocPaperSize.Tabloid,
PdfConfig = new PdfConfig { ExtractHyperlinks = true, HyperlinksPageCount = 5, AllowCopy = true }
};
case ".PDF":
return new PdfConfig { AllowSearch = true, AllowCopy = true };
case ".XLS": case ".XLSX": case ".ODS": case ".CSV":
return new ExcelConfig { AllowSearch = true, AllowCopy = true };
case ".DCM": case ".IMA":
return new DicomConfig { DisplayMode = DicomDisplayMode.AnimationAndFrames };
// DefaultRender = false → PDF redirect → pixel-accurate native text search
case ".HTML": case ".HTM":
return new HtmlConfig { DefaultRender = false };
case ".EML": case ".EMLX": case ".MSG":
return new EmailConfig { DefaultRender = false };
default:
return null; // fall back to the format's default config
}
}האם דף זה היה מועיל?