تكوينات الصيغة

خيارات العرض الكاملة لكل صيغة

كل مستند يفتح باستخدام تنفيذ 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. يتطلب قدرة ترخيص البحث للطلبات.
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>SheetNamesفارغتقييد العرض إلى أوراق العمل المسماة.
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.

EmailConfig

الصيغ: 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, and 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 Plugin.

النوعالخاصيةالافتراضيالسلوك
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صورة Gantt أصلية؛ 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, and 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 // العودة إلى الإعداد الافتراضي لـ format config
};

هل كانت هذه الصفحة مفيدة؟