Formatkonfigurationer
Fullständiga renderingsalternativ per format
Varje dokument öppnas med en BaseConfig-implementation. Skicka en till OpenDocumentAsync eller låt formatkatalogen skapa sin standard. Alla klasser nedan finns i Doconut-namnutrymmet.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
AllowSearch = true,
AllowCopy = true,
ImageResolution = 150
});Arv och nästlade PDF-inställningar
Varje format ärver de fem BaseConfig-egenskaperna. Format som kan omdirigera via PDF exponerar en nästlad PdfConfig. I WordConfig, ExcelConfig och PptConfig är AllowSearch och AllowCopy bekvämlighetsegenskaper som läser och skriver den nästlade PdfConfig.
DefaultRender = true väljer den inhemska formatrenderaren. På format med en PDF‑omdirigering konverterar false först till en PDF i minnet och använder sedan PDF‑visaren. Den vägen är ofta användbar för text‑koordinatsökning, men kostar en extra konvertering.
Om inte annat anges visar tabellerna standardvärden för konstruktorer/egenskaper. Den automatiska formatkatalogen åsiktligt åsidosätter två av dem: den skapar ExcelConfig med SplitWorksheets = true, och MhtConfig med DefaultRender = false.
BaseConfig
| Typ | Egenskap | Standard | Beteende |
|---|---|---|---|
int | ImageResolution | 0 | 0 använder formatets standard. Giltigt explicit intervall är 25-300 DPI; ogiltiga tilldelningar ignoreras. |
string | DocumentCulture | "" | Språkinställning för datum och tal. Icke‑tomma värden trimmas; tomma tilldelningar ignoreras. |
string | Password | "" | Lösenord för skyddat dokument. DocOptions.Password kopieras hit automatiskt. |
bool | ShowUI | true | Kompatibilitetsegenskap; den aktuella renderaren använder den inte för att styra webbläsarens verktygsfält. |
bool | CachePages | true | Cacha renderade sidbilder för dokumentsessionen. |
PdfConfig
Format: PDF. Standard DPI: 200.
| Typ | Egenskap | Standard | Beteende |
|---|---|---|---|
bool | DefaultRender | true | Kompatibilitetsswitch. Den aktuella fabriken använder den inhemska PDF‑visaren. |
bool | AllowSearch | false | Bygg/använd PDF‑textsökindexet. Kräver Search‑licenskapacitet för förfrågningar. |
bool | AllowCopy | false | Tillåt textmarkering/kopiering. |
bool | ExtractHyperlinks | false | Extrahera länkrektanglar för klientöverläggningar. |
int | HyperlinksPageCount | 0 | Maximalt antal sidor som skannas för länkar; 0 betyder varje sida. |
bool | CompressImages | false | Komprimera inbäddade bilder före rendering. |
int | CompressQuality | 100 | JPEG‑kvalitet som används när komprimering är aktiverad. |
bool | ResizeImages | false | Ändra storlek på inbäddade bilder före rendering. |
int | ResizeResolution | 300 | MåldPI för storleksändrade bilder. |
bool | CompressFast | false | Föredra den snabbare, lägre kvalitetskomprimeringsvägen. |
bool | FixInvalidImages | false | Försök reparera ogiltiga inbäddade bilder. |
bool | SplitSegments | false | Sammanfoga ord som delats över radsegment för att förbättra sökning/kopiering. |
showHyperlinks i ViewerConfig styr klientöverläggningen, medan ExtractHyperlinks styr serverextraktion. Aktivera båda.
WordConfig
Format: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, XML. Standard DPI: 200.
| Typ | Egenskap | Standard | Beteende |
|---|---|---|---|
bool | DefaultRender | true | Inbyggd Word-rendering; false använder PDF‑omdirigeringen. |
PdfConfig | PdfConfig | new instance | Inställningar som används av PDF/sökvägen. |
DocPaperSize | PaperSize | A4 | Utskriftspappersstorlek. Använd Custom med bredd/höjd. |
int | PaperWidth | 595 | Anpassad bredd i punkter. |
int | PaperHeight | 841 | Anpassad höjd i punkter. |
bool | RemovePaperMargin | false | Ta bort dokumentets sidomarginaler. |
bool | RenderPageColor | true | Bevara Words konfigurerade sidfärg; false renderar vita sidor. |
bool | ExportPdfA | false | Använd arkiv‑PDF/A på PDF‑vägen. |
Encoding? | FileEncoding | null | Åsidosätt källkodning. |
string | FontInfo | "" | Information om teckensnittssubstitution. |
string[]? | FontFolders | null | Ytterligare teckensnittskataloger, särskilt användbara i Linux/containers. |
bool | AllowSearch | false | Delegerar till PdfConfig.AllowSearch. |
bool | AllowCopy | false | Delegerar till PdfConfig.AllowCopy. |
TableAutoFitBehavior | AutoFitAllTables | None | None, AutoFitToContents eller AutoFitToWindow. |
ExcelKonfiguration
Format: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. Standard DPI: 200.
| Typ | Egenskap | Standard | Beteende |
|---|---|---|---|
bool | DefaultRender | true | Inbyggd bladrendering; false använder PDF-omdirigeringen. |
PdfConfig | PdfConfig | ny instans | Inställningar för PDF/sökvägen. |
ExcelPaperSize | PaperSize | PaperA4 | Utskriftspappersstorlek. |
double | PaperMargins | 0.25 | Sidmarginaler i tum. |
bool | PaperLandscape | true | Landskapsbladrendering. |
bool | AutoFitContents | false | Automatisk anpassning av radhöjder och kolumnbredder. |
bool | RemoveEmptyContent | true | Komprimera utskriften genom att utesluta tomt innehåll. |
bool | CalculateFormula | true | Beräkna om formler före rendering. |
bool | ShowRowColumnHeaders | true | Inkludera kalkylbladsrubriker. |
bool | ExportPdfA | false | Använd PDF/A på PDF-sökvägen. |
bool | SplitWorksheets | false | Behåll arbetsblad som separata sidgrupper. |
bool | ShowEmptyWorkSheets | false | Inkludera tomma arbetsblad. |
bool | ExportLandscape | false | Tvinga landskapsexport. |
bool | ExportOnePagePerSheet | false | Anpassa varje arbetsblad till en utskriftsida. |
bool | MemoryOptimizationPreference | true | Minska maxminne, eventuellt på bekostnad av hastighet. |
bool | AutoTrimWorksheetRenderRange | true | Rendera endast det synliga använda området när inget explicit utskriftsområde finns. |
bool | AutoTrimPreserveExistingPrintArea | true | Bevara arbetsboksdefinierade utskriftsområden under automatisk trimning. |
string? | PrintArea | null | Explicit område såsom "A1:Z100". |
bool | PrintGridlines | false | Skriv ut arbetsbladsrutnät. |
bool | PrintHeadings | false | Skriv ut rad-/kolumnrubriker. |
List<string> | SheetNames | tom | Begränsa rendering till namngivna arbetsblad. |
CustomStyleCell? | CustomStyles | null | Valfria datum-/decimal-/heltalformatöverskrivningar. |
bool | AllowSearch | false | Delegerar till PdfConfig.AllowSearch. |
bool | AllowCopy | false | Delegerar till PdfConfig.AllowCopy. |
CustomStyleCell exponerar CustomStyleDateTime, CustomStyleNumberDecimal och CustomStyleNumberInteger, alla nullable strängar.
new ExcelConfig() sätter SplitWorksheets till false; att öppna en Excel-fil utan en explicit konfiguration använder formatkatalogen, som sätter den till true.
PptKonfiguration
Format: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. Standard DPI: 200.
| Typ | Egenskap | Standard | Beteende |
|---|---|---|---|
bool | DefaultRender | true | Inbyggd bildspelsrendering; false använder PDF-omdirigeringen. |
bool | FastLoad | false | Undvik rendering av den första bilden vid öppning; använd metadata och rendera vid behov. |
PdfConfig | PdfConfig | ny instans | Inställningar för PDF/sökbeteende. |
string | FontInfo | "" | Information om teckensnittssubstitution. |
string[]? | FontFolders | null | Ytterligare teckensnittskataloger. |
bool | AllowSearch | false | Delegerar till PdfConfig.AllowSearch. |
bool | AllowCopy | false | Delegerar till PdfConfig.AllowCopy. |
Sidor ritas med de teckensnitt som är installerade på servern. På Linux, installera de teckensnitt som presentationerna använder eller peka FontFolders mot dem: ett saknat teckensnitt ersätts utan fel, så radbrytningar kan skilja sig från Windows. fonts-liberation, fonts-crosextra-carlito och fonts-crosextra-caladea ger metrisk-kompatibla ersättningar för de vanliga Windows-teckensnitten. Linux behöver bara libfontconfig1 (libgdiplus krävs inte).
CadKonfiguration
Format: DWG, DXF, DGN. Standard DPI: 200.
| Typ | Egenskap | Standard | Beteende |
|---|---|---|---|
bool | DefaultRender | true | Inbyggd CAD-rendering; false använder PDF-omdirigeringen. |
PdfConfig | PdfConfig | ny instans | Inställningar för PDF-sökväg. |
bool | ExportPdfA | false | Arkiverad PDF/A-utdata. |
bool | ShowColor | true | Färg snarare än monokrom. |
bool | WhiteBackground | true | Vit bakgrund istället för svart. |
short | LineWidth | 25 | CAD-streckbredd. |
bool | ShowLayouts | false | Rendera layoutflikar. |
bool | ShowModel | true | Rendera modellutrymme. |
bool | Check3DSolid | true | Bearbeta 3D-solider. |
bool | ExportAllLayouts | false | Exportera alla layouter, åsidosätt modell/layout-val. |
bool | LimitMinimumSize | false | Applicera MinimumSize. |
int | MinimumSize | 700 | Minsta utskriftsstorlek i pixlar. |
bool | LimitMaximumSize | false | Applicera MaximumSize. |
int | MaximumSize | 700 | Maximal utskriftsstorlek i pixlar. |
bool | ShowAllLayoutsDgn | false | Inkludera alla DGN-layouter. |
bool | AutomaticLayoutScaling | true | Skala layouter automatiskt. |
float | PdfMargins | 0.5 | PDF-marginal i tum. |
RenderQuality | QualityImage | Low | Rasterkvalitet: Low, Medium eller High. |
RenderQuality | QualityText | Medium | Textkvalitet: Low, Medium eller High. |
EmailConfig
Format: EML, EMLX, MSG. Standard DPI: 200.
| Type | Property | Default | Behavior |
|---|---|---|---|
bool | DefaultRender | true | Inbyggd e‑postrendering; false använder PDF‑omdirigeringen. |
PdfConfig | PdfConfig | ny instans | Inställningar för PDF‑sökväg. |
Encoding? | EmailEncoding | null | Åsidosätt meddelandekodning. |
Encoding? | SubjectEncoding | null | Åsidosätt ämneskodning. |
Encoding? | BodyEncoding | null | Åsidosätt brödtextkodning. |
bool | SkipExternalImages | false | Ladda inte ner fjärrrefererade bilder. Rekommenderas för opålitlig e‑post. |
bool | RemoveLastWhitePage | false | Ta bort en avslutande tom sida. |
bool | UseAntiAliasing | false | Aktivera kantutjämning. |
bool | UseHighQualityRendering | false | Föredra renare, långsammare rendering. |
TimeSpan? | TimeZoneOffset | null | Åsidosätt tidszonen som används för datum. |
bool | ForcePageSize | false | Tvinga fasta sidmått. |
ImageConfig, TiffConfig, and PsdConfig
ImageConfig omfattar JPG, JPEG, JPE, PNG, BMP, GIF, ICO, EPS, TGA, WEBP, CDR, CMX, DNG, EMF, WMF, AVIF och SVG. Dess standard DPI är 100.
| Config | Property | Default | Behavior |
|---|---|---|---|
ImageConfig | MaxImagePixelSize | 3000 | Maximal bredd/höjd. 0 betyder obegränsat; nollskilda värden under 50 ignoreras. |
ImageConfig | TransparentPng | true | Bevara PNG-transparens; false använder en vit bakgrund. |
TiffConfig | inga ytterligare egenskaper | DPI 200 | Använder endast BaseConfig; stöder flersidig TIFF. |
PsdConfig | MaxImagePixelSize | 3000 | Samma 0/minimum-50 validering som ImageConfig; standard DPI är 100. |
DicomConfig
Format: DCM, IMA. Standard effektiv DPI: 100. Kräver DICOM‑plugin.
| Type | Property | Default | Behavior |
|---|---|---|---|
int | HorizontalResolution | 100 effective | Explicit horisontell DPI; annars ImageResolution, sedan 100. |
int | VerticalResolution | 100 effective | Explicit vertikal DPI; annars ImageResolution, sedan 100. |
int | AnimationFrameDelayMs | 100 | Fördröjning för multiramavideo; GIF-timing använder 10 ms‑enheter. |
ushort | LoopCount | 0 | 0 loopar för alltid; positiva värden stoppar efter det antalet. |
DicomDisplayMode | DisplayMode | AnimationAndFrames | AnimationOnly, FramesOnly, eller kombinerad översikt plus statiska ramar. |
TxtConfig
Format: TXT. Standard DPI: 200.
| Type | Property | Default | Behavior |
|---|---|---|---|
DocPaperSize | PaperSize | A4 | Utskriftsformat för papper. |
Encoding? | FileEncoding | null | null använder UTF-8. |
string | FontInformation | "" | Typsnittsinformation för textrendering. |
Använd WordConfig när vanlig text behöver rikare sidlayoutbeteende.
ProjectConfig
Format: MPP, MPPX, MPX. Standard DPI: 200.
| Type | Property | Default | Behavior |
|---|---|---|---|
bool | DefaultRender | true | Inbyggd Gantt-bild; false använder en textbaserad PDF‑sökväg. |
PdfConfig | PdfConfig | ny instans | Inställningar för PDF‑sökväg. |
bool | ExportPdfA | true | Arkiv-PDF/A-utdata. |
MppPaperSize | PaperSize | Ledger | Projektets utskriftsformat för papper. |
MppTimeScale | TimeScale | Months | Days eller Months. |
MppFormat | PresentationFormat | GanttChart | GanttChart, TaskUsage, ResourceUsage, ResourceSheet, eller TaskSheet. |
För exakt textkoordinatsökning, använd DefaultRender = false.
VisioConfig
Format: VSD, VSDX, VSS, VSSX, VST, VSTX, VDX, VSX, VSDM. Standard DPI: 200.
| Type | Property | Default | Behavior |
|---|---|---|---|
bool | DefaultRender | true | Inbyggd diagramrendering; false använder PDF‑omdirigeringen. |
PdfConfig | PdfConfig | ny instans | Inställningar för PDF‑sökväg. |
bool | ExportPdfA | true | Arkiv-PDF/A-utdata. |
HtmlConfig, EpubConfig, MhtConfig, and XpsConfig
Alla fyra har standard 200 DPI och exponerar en nästlad PdfConfig.
| Config | Formats | DefaultRender | Ytterligare egenskaper/beteende |
|---|---|---|---|
HtmlConfig | HTML, HTM | true | Inbyggd rendering; använd false för en textbaserad PDF‑sökväg. |
EpubConfig | EPUB | true | Inbyggd rendering; false använder PDF. |
MhtConfig | MHT, MHTML | true på klassen; false i den automatiska katalogen | Den normala öppningen utan konfiguration använder den sökbara PDF‑omdirigeringen. En explicit konstruerad standardinstans renderar inbyggt. |
XpsConfig | XPS | false | Använder PDF‑sökvägen som standard; sätt true för inbyggd bildrendering. |
Konfigurationsexempel per familj
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
}
];Urval per filändelse
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-omdirigering → pixel‑exakt inbyggd textsökning
".HTML" or ".HTM" => new HtmlConfig { DefaultRender = false },
".EML" or ".EMLX" or ".MSG" => new EmailConfig { DefaultRender = false },
_ => null // återgå till formatets standardkonfiguration
};Var den här sidan hjälpsam?