Διαμορφώσεις Μορφής
Πλήρεις επιλογές απόδοσης ανά μορφή
Κάθε έγγραφο ανοίγει με μια υλοποίηση 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 | new instance | Ρυθμίσεις για τη διαδρομή 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, όλες nullable συμβολοσειρές.
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 | new instance | Ρυθμίσεις για τη συμπεριφορά 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 | new instance | Ρυθμίσεις διαδρομής 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 | Επεξεργασία στερεών 3Δ. |
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 | Ποιότητα raster: Low, Medium ή High. |
RenderQuality | QualityText | Medium | Ποιότητα κειμένου: Low, Medium ή High. |
EmailConfig
Μορφές: EML, EMLX, MSG. Προεπιλεγμένο DPI: 200.
| Τύπος | Ιδιότητα | Προεπιλογή | Συμπεριφορά |
|---|---|---|---|
bool | DefaultRender | true | Γενική απόδοση email· false χρησιμοποιεί την ανακατεύθυνση PDF. |
PdfConfig | PdfConfig | νέα παρουσία | Ρυθμίσεις διαδρομής PDF. |
Encoding? | EmailEncoding | null | Παράκαμψη κωδικοποίησης μηνύματος. |
Encoding? | SubjectEncoding | null | Παράκαμψη κωδικοποίησης θέματος. |
Encoding? | BodyEncoding | null | Παράκαμψη κωδικοποίησης σώματος. |
bool | SkipExternalImages | false | Μην φορτώνετε εικόνες που αναφέρονται απομακρυσμένα. Συνιστάται για μη αξιόπιστο email. |
bool | RemoveLastWhitePage | false | Αφαίρεση τελικής κενής σελίδας. |
bool | UseAntiAliasing | false | Ενεργοποίηση anti-aliasing. |
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/minimum-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 | Καθυστέρηση animation πολλαπλών καρέ· ο χρόνος GIF χρησιμοποιεί μονάδες 10 ms. |
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 | Χρησιμοποιεί τη διαδρομή 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 redirect → αναζήτηση εγγενούς κειμένου με ακρίβεια pixel
".HTML" or ".HTM" => new HtmlConfig { DefaultRender = false },
".EML" or ".EMLX" or ".MSG" => new EmailConfig { DefaultRender = false },
_ => null // επιστροφή στην προεπιλεγμένη ρύθμιση του μορφότυπου
};Ήταν αυτή η σελίδα χρήσιμη;