HtmlSaveOptions

HtmlSaveOptions class

يمكن استخدامه لتحديد خيارات إضافية عند حفظ مستند في Html ,Mhtml ,EpubAzw3 أوMobi التنسيق.

لمعرفة المزيد، قم بزيارةحدد خيارات الحفظ مقالة توثيقية.

public class HtmlSaveOptions : SaveOptions

المنشئون

اسموصف
HtmlSaveOptions()تهيئة مثيل جديد لهذه الفئة يمكن استخدامه لحفظ document فيHtml التنسيق.
HtmlSaveOptions(SaveFormat)تهيئة مثيل جديد لهذه الفئة يمكن استخدامه لحفظ document فيHtml ,Mhtml ,EpubAzw3 أوMobi التنسيق.

الخصائص

اسموصف
AllowEmbeddingPostScriptFonts { get; set; }الحصول على قيمة منطقية أو تعيينها تشير إلى ما إذا كان سيتم السماح بدمج الخطوط باستخدام مخططات PostScript عند حفظ تضمين خطوط TrueType في مستند. القيمة الافتراضية هيخطأ شنيع .
AllowNegativeIndent { get; set; }يحدد ما إذا كانت المسافات البادئة السلبية اليمنى واليسرى للفقرات ستتم تسويتها عند الحفظ في HTML أو MHTML أو EPUB. القيمة الافتراضية هيخطأ شنيع .
CssClassNamePrefix { get; set; }تحديد بادئة تتم إضافتها إلى كافة أسماء فئات CSS. القيمة الافتراضية هي سلسلة فارغة وأسماء فئات CSS التي تم إنشاؤها لا تحتوي على بادئة مشتركة.
CssSavingCallback { get; set; }يسمح بالتحكم في كيفية حفظ أنماط CSS عند حفظ مستند بتنسيق HTML أو MHTML أو EPUB.
CssStyleSheetFileName { get; set; }يحدد المسار واسم ملف ورقة الأنماط المتتالية (CSS) الذي يتم كتابته عند تصدير مستند إلى HTML. الافتراضي هو سلسلة فارغة.
CssStyleSheetType { get; set; }يحدد كيفية تصدير أنماط CSS (ورقة الأنماط المتتالية) إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيInline لـ HTML/MHTML و External لـ EPUB.
CustomTimeZoneInfo { get; set; }الحصول على أو تعيين المنطقة الزمنية المحلية المخصصة المستخدمة لحقول التاريخ/الوقت.
DefaultTemplate { get; set; }الحصول على أو تعيين المسار إلى القالب الافتراضي (بما في ذلك اسم الملف). القيمة الافتراضية لهذه الخاصية هيسلسلة فارغة (Empty).
Dml3DEffectsRenderingMode { get; set; }الحصول على قيمة أو تعيينها لتحديد كيفية عرض التأثيرات ثلاثية الأبعاد.
virtual DmlEffectsRenderingMode { get; set; }الحصول على قيمة أو تعيينها لتحديد كيفية عرض تأثيرات DrawML.
DmlRenderingMode { get; set; }الحصول على قيمة أو تعيينها لتحديد كيفية عرض أشكال DrawML.
DocumentPartSavingCallback { get; set; }يسمح بالتحكم في كيفية حفظ أجزاء المستند عند حفظ مستند بتنسيق HTML أو EPUB.
DocumentSplitCriteria { get; set; }يحدد كيفية تقسيم المستند عند الحفظ فيهHtmlEpub أوAzw3 شكل. الافتراضي هوNone لـ HTML و HeadingParagraph لـ EPUB وAZW3.
DocumentSplitHeadingLevel { get; set; }يحدد الحد الأقصى لمستوى العناوين التي سيتم عندها تقسيم المستند. القيمة الافتراضية هي2 .
Encoding { get; set; }يحدد الترميز الذي سيتم استخدامه عند التصدير إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيترميز UTF8 الجديد (خطأ) (UTF-8 بدون قائمة مكونات الصنف).
ExportCidUrlsForMhtmlResources { get; set; }يحدد ما إذا كان سيتم استخدام عناوين URL لـ CID (معرف المحتوى) للإشارة إلى الموارد (الصور والخطوط وCSS) المضمنة في مستندات MHTML . القيمة الافتراضية هيخطأ شنيع .
ExportDocumentProperties { get; set; }يحدد ما إذا كان سيتم تصدير خصائص المستند المضمنة والمخصصة إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيخطأ شنيع .
ExportDropDownFormFieldAsText { get; set; }يتحكم في كيفية حفظ حقول النموذج المنسدل في HTML أو MHTML. القيمة الافتراضية هيخطأ شنيع .
ExportFontResources { get; set; }يحدد ما إذا كان يجب تصدير موارد الخطوط إلى HTML أو MHTML أو EPUB. الافتراضي هوخطأ شنيع .
ExportFontsAsBase64 { get; set; }يحدد ما إذا كان يجب تضمين موارد الخطوط في HTML في ترميز Base64. الافتراضي هوخطأ شنيع .
ExportGeneratorName { get; set; }متىحقيقي ، يؤدي إلى تضمين اسم وإصدار Aspose.Words في الملفات المنتجة. القيمة الافتراضية هيحقيقي .
ExportHeadersFootersMode { get; set; }يحدد كيفية إخراج الرؤوس والتذييلات إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيPerSection لـ HTML/MHTML وNone لـ EPUB.
ExportImagesAsBase64 { get; set; }يحدد ما إذا كان سيتم حفظ الصور بتنسيق Base64 إلى مخرجات HTML أو MHTML أو EPUB. الافتراضي هوخطأ شنيع .
ExportLanguageInformation { get; set; }يحدد ما إذا كان سيتم تصدير معلومات اللغة إلى HTML أو MHTML أو EPUB. الإعداد الافتراضي هوخطأ شنيع .
ExportListLabels { get; set; }يتحكم في كيفية إخراج تسميات القائمة إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيAuto .
ExportOriginalUrlForLinkedImages { get; set; }يحدد ما إذا كان يجب استخدام عنوان URL الأصلي كعنوان URL للصور المرتبطة. القيمة الافتراضية هيخطأ شنيع .
ExportPageMargins { get; set; }يحدد ما إذا كان سيتم تصدير هوامش الصفحة إلى HTML أو MHTML أو EPUB. الإعداد الافتراضي هوخطأ شنيع .
ExportPageSetup { get; set; }يحدد ما إذا كان سيتم تصدير إعداد الصفحة إلى HTML أو MHTML أو EPUB. الإعداد الافتراضي هوخطأ شنيع .
ExportRelativeFontSize { get; set; }يحدد ما إذا كان يجب إخراج أحجام الخطوط بوحدات نسبية عند الحفظ في HTML أو MHTML أو EPUB. الإعداد الافتراضي هوخطأ شنيع .
ExportRoundtripInformation { get; set; }يحدد ما إذا كان سيتم كتابة معلومات رحلة الذهاب والإياب عند الحفظ في HTML أو MHTML أو EPUB. القيمة الافتراضية هيحقيقي لـ HTML وخطأ شنيع لـ MHTML وEPUB.
ExportShapesAsSvg { get; set; }يتحكم في ما إذا كانShapeيتم تحويل العقد إلى صور SVG عند حفظ إلى HTML أو MHTML أو EPUB أو AZW3. القيمة الافتراضية هيخطأ شنيع .
ExportTextInputFormFieldAsText { get; set; }يتحكم في كيفية حفظ حقول نموذج إدخال النص في HTML أو MHTML. القيمة الافتراضية هيخطأ شنيع .
ExportTocPageNumbers { get; set; }يحدد ما إذا كان سيتم كتابة أرقام الصفحات في جدول المحتويات عند حفظ HTML وMHTML وEPUB. القيمة الافتراضية هيخطأ شنيع .
ExportXhtmlTransitional { get; set; }يحدد ما إذا كان سيتم كتابة إعلان DOCTYPE عند الحفظ في HTML أو MHTML. متىحقيقي ، يكتب إعلان DOCTYPE في المستند قبل العنصر الجذر. القيمة الافتراضية هيخطأ شنيع. عند الحفظ في EPUB أو HTML5 (Html5 ) يتم دائمًا كتابة إعلان DOCTYPE .
FontResourcesSubsettingSizeThreshold { get; set; }يتحكم في موارد الخطوط التي تحتاج إلى تعيين فرعي عند الحفظ في HTML أو MHTML أو EPUB. الإعداد الافتراضي هو0 .
FontSavingCallback { get; set; }يسمح بالتحكم في كيفية حفظ الخطوط عند حفظ مستند بتنسيق HTML أو MHTML أو EPUB.
FontsFolder { get; set; }يحدد المجلد الفعلي حيث يتم حفظ الخطوط عند تصدير مستند إلى HTML. الافتراضي هو سلسلة فارغة.
FontsFolderAlias { get; set; }يحدد اسم المجلد المستخدم لإنشاء معرفات URI للخط المكتوب في مستند HTML. الافتراضي هو سلسلة فارغة.
HtmlVersion { get; set; }يحدد إصدار معيار HTML الذي يجب استخدامه عند حفظ المستند إلى HTML أو MHTML. القيمة الافتراضية هيXhtml .
ImageResolution { get; set; }يحدد دقة الإخراج للصور عند التصدير إلى HTML أو MHTML أو EPUB. الافتراضي هو96 نقطة في البوصة .
ImageSavingCallback { get; set; }يسمح بالتحكم في كيفية حفظ الصور عند حفظ مستند بتنسيق HTML أو MHTML أو EPUB.
ImagesFolder { get; set; }يحدد المجلد الفعلي حيث يتم حفظ الصور عند تصدير مستند إلى تنسيق HTML. الافتراضي هو سلسلة فارغة.
ImagesFolderAlias { get; set; }يحدد اسم المجلد المستخدم لإنشاء معرفات URI للصور المكتوبة في مستند HTML. الافتراضي هو سلسلة فارغة.
ImlRenderingMode { get; set; }الحصول على قيمة أو تعيينها لتحديد كيفية عرض كائنات الحبر (InkML).
MemoryOptimization { get; set; }الحصول على أو تحديد القيمة التي تحدد ما إذا كان يجب إجراء تحسين الذاكرة قبل حفظ المستند. القيمة الافتراضية لهذه الخاصية هيخطأ شنيع .
MetafileFormat { get; set; }يحدد التنسيق الذي سيتم حفظ ملفات التعريف عند التصدير إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيPng ، مما يعني أن ملفات التعريف يتم عرضها على صور PNG النقطية.
NavigationMapLevel { get; set; }يحدد الحد الأقصى لمستوى العناوين التي يتم ملؤها في خريطة التنقل عند التصدير إلى تنسيقات EPUB، أو MOBI، أو AZW3 . القيمة الافتراضية هي3 .
OfficeMathOutputMode { get; set; }يتحكم في كيفية تصدير كائنات OfficeMath إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيImage .
PrettyFormat { get; set; }متىحقيقي، إخراج تنسيقات جميلة حيثما ينطبق ذلك. القيمة الافتراضية هيخطأ شنيع .
ProgressCallback { get; set; }يتم الاتصال به أثناء حفظ مستند ويقبل البيانات المتعلقة بتقدم الحفظ.
ResolveFontNames { get; set; }يحدد ما إذا كان سيتم حل أسماء مجموعة الخطوط المستخدمة في المستند واستبدالها وفقًا لـ FontSettings عند كتابتها بتنسيقات مستندة إلى HTML.
ResourceFolder { get; set; }يحدد مجلدًا فعليًا حيث يتم حفظ جميع الموارد مثل الصور والخطوط وCSS الخارجية عند تصدير document إلى HTML. الافتراضي هو سلسلة فارغة.
ResourceFolderAlias { get; set; }يحدد اسم المجلد المستخدم لإنشاء URIs لجميع الموارد المكتوبة في مستند HTML. الافتراضي هو سلسلة فارغة.
override SaveFormat { get; set; }يحدد التنسيق الذي سيتم حفظ المستند به في حالة استخدام كائن خيارات الحفظ هذا. يمكن أن يكونHtml ,Mhtml ,EpubAzw3 أوMobi .
ScaleImageToShapeSize { get; set; }يحدد ما إذا كان سيتم تغيير حجم الصور بواسطة Aspose.Words إلى حجم الشكل المحيط عند التصدير إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيحقيقي .
TableWidthOutputMode { get; set; }يتحكم في كيفية تصدير عروض الجدول والصف والخلية إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيAll .
TempFolder { get; set; }يحدد المجلد للملفات المؤقتة المستخدمة عند الحفظ في ملف DOC أو DOCX. بشكل افتراضي، تكون هذه الخاصيةباطل ولا يتم استخدام أي ملفات مؤقتة.
UpdateCreatedTimeProperty { get; set; }الحصول على أو تعيين قيمة لتحديد ما إذا كانCreatedTime يتم تحديث الخاصية قبل الحفظ. القيمة الافتراضية هيخطأ شنيع ;
UpdateFields { get; set; }الحصول على قيمة أو تعيينها لتحديد ما إذا كان يجب تحديث الحقول من أنواع معينة قبل حفظ المستند بتنسيق صفحة ثابت. القيمة الافتراضية لهذه الخاصية هيحقيقي .
UpdateLastPrintedProperty { get; set; }الحصول على أو تعيين قيمة لتحديد ما إذا كانLastPrinted يتم تحديث الخاصية قبل الحفظ.
UpdateLastSavedTimeProperty { get; set; }الحصول على أو تعيين قيمة لتحديد ما إذا كانLastSavedTime يتم تحديث الخاصية قبل الحفظ.
UseAntiAliasing { get; set; }الحصول على قيمة أو تعيينها لتحديد ما إذا كان سيتم استخدام الصقل للعرض أم لا.
UseHighQualityRendering { get; set; }الحصول على قيمة أو تعيينها لتحديد ما إذا كان سيتم استخدام خوارزميات عرض عالية الجودة (أي بطيئة) أم لا.

أمثلة

يوضح كيفية تحديد المجلد لتخزين الصور المرتبطة بعد حفظها في .html.

Document doc = new Document(MyDir + "Rendering.docx");

string imagesDir = Path.Combine(ArtifactsDir, "SaveHtmlWithOptions");

if (Directory.Exists(imagesDir))
    Directory.Delete(imagesDir, true);

Directory.CreateDirectory(imagesDir);

// قم بتعيين خيار لتصدير حقول النموذج كنص عادي بدلاً من عناصر إدخال HTML.
HtmlSaveOptions options = new HtmlSaveOptions(SaveFormat.Html)
{
    ExportTextInputFormFieldAsText = true, 
    ImagesFolder = imagesDir
};

doc.Save(ArtifactsDir + "HtmlSaveOptions.SaveHtmlWithOptions.html", options);

يوضح كيفية استخدام ترميز معين عند حفظ مستند إلى .epub.

Document doc = new Document(MyDir + "Rendering.docx");

// استخدم كائن SaveOptions لتحديد ترميز المستند الذي سنقوم بحفظه.
HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.SaveFormat = SaveFormat.Epub;
saveOptions.Encoding = Encoding.UTF8;

// بشكل افتراضي، سيحتوي مستند الإخراج .epub على جميع محتوياته في جزء HTML واحد.
// يسمح لنا معيار التقسيم بتقسيم المستند إلى عدة أجزاء بتنسيق HTML.
// سنضع المعايير لتقسيم الوثيقة إلى فقرات رأسية.
// هذا مفيد للقراء الذين لا يستطيعون قراءة ملفات HTML ذات حجم أكبر من حجم معين.
saveOptions.DocumentSplitCriteria = DocumentSplitCriteria.HeadingParagraph;

// حدد أننا نريد تصدير خصائص المستند.
saveOptions.ExportDocumentProperties = true;

doc.Save(ArtifactsDir + "HtmlSaveOptions.Doc2EpubSaveOptions.epub", saveOptions);

يوضح كيفية تقسيم مستند إلى أجزاء وحفظها.

public void DocumentPartsFileNames()
{
    Document doc = new Document(MyDir + "Rendering.docx");
    string outFileName = "SavingCallback.DocumentPartsFileNames.html";

    // قم بإنشاء كائن "HtmlFixedSaveOptions"، والذي يمكننا تمريره إلى طريقة "حفظ" المستند
    // لتعديل كيفية تحويل المستند إلى HTML.
    HtmlSaveOptions options = new HtmlSaveOptions();

    // إذا قمنا بحفظ المستند بشكل طبيعي، فسيكون هناك مخرج HTML واحد
    // مستند يحتوي على جميع محتويات المستند المصدر.
    // قم بتعيين خاصية "DocumentSplitCriteria" على "DocumentSplitCriteria.SectionBreak" إلى
    // احفظ وثيقتنا في ملفات HTML متعددة: ملف واحد لكل قسم.
    options.DocumentSplitCriteria = DocumentSplitCriteria.SectionBreak;

    // قم بتعيين رد اتصال مخصص للخاصية "DocumentPartSavingCallback" لتغيير منطق حفظ جزء المستند.
    options.DocumentPartSavingCallback = new SavedDocumentPartRename(outFileName, options.DocumentSplitCriteria);

    // إذا قمنا بتحويل مستند يحتوي على صور إلى html، فسوف نحصل في النهاية على ملف html واحد يرتبط بعدة صور.
    // ستكون كل صورة على شكل ملف في نظام الملفات المحلي.
    // يوجد أيضًا رد اتصال يمكنه تخصيص الاسم وموقع نظام الملفات لكل صورة.
    options.ImageSavingCallback = new SavedImageRename(outFileName);

    doc.Save(ArtifactsDir + outFileName, options);
}

/// <summary>
/// يعين أسماء ملفات مخصصة لمستندات الإخراج التي تقوم عملية الحفظ بتقسيم المستند إليها.
/// </summary>
private class SavedDocumentPartRename : IDocumentPartSavingCallback
{
    public SavedDocumentPartRename(string outFileName, DocumentSplitCriteria documentSplitCriteria)
    {
        mOutFileName = outFileName;
        mDocumentSplitCriteria = documentSplitCriteria;
    }

    void IDocumentPartSavingCallback.DocumentPartSaving(DocumentPartSavingArgs args)
    {
        // يمكننا الوصول إلى المستند المصدر بأكمله عبر خاصية "المستند".
        Assert.True(args.Document.OriginalFileName.EndsWith("Rendering.docx"));

        string partType = string.Empty;

        switch (mDocumentSplitCriteria)
        {
            case DocumentSplitCriteria.PageBreak:
                partType = "Page";
                break;
            case DocumentSplitCriteria.ColumnBreak:
                partType = "Column";
                break;
            case DocumentSplitCriteria.SectionBreak:
                partType = "Section";
                break;
            case DocumentSplitCriteria.HeadingParagraph:
                partType = "Paragraph from heading";
                break;
        }

        string partFileName = $"{mOutFileName} part {++mCount}, of type {partType}{Path.GetExtension(args.DocumentPartFileName)}";

        // فيما يلي طريقتان لتحديد المكان الذي سيحفظ فيه Aspose.Words كل جزء من المستند.
        // 1 - قم بتعيين اسم ملف لملف جزء الإخراج:
        args.DocumentPartFileName = partFileName;

        // 2 - إنشاء دفق مخصص لملف جزء الإخراج:
        args.DocumentPartStream = new FileStream(ArtifactsDir + partFileName, FileMode.Create);

        Assert.True(args.DocumentPartStream.CanWrite);
        Assert.False(args.KeepDocumentPartStreamOpen);
    }

    private int mCount;
    private readonly string mOutFileName;
    private readonly DocumentSplitCriteria mDocumentSplitCriteria;
}

/// <summary>
/// يعين أسماء ملفات مخصصة لملفات الصور التي ينشئها تحويل HTML.
/// </summary>
public class SavedImageRename : IImageSavingCallback
{
    public SavedImageRename(string outFileName)
    {
        mOutFileName = outFileName;
    }

    void IImageSavingCallback.ImageSaving(ImageSavingArgs args)
    {
        string imageFileName = $"{mOutFileName} shape {++mCount}, of type {args.CurrentShape.ShapeType}{Path.GetExtension(args.ImageFileName)}";

        // فيما يلي طريقتان لتحديد المكان الذي سيحفظ فيه Aspose.Words كل جزء من المستند.
        // 1 - قم بتعيين اسم ملف لملف الصورة الناتج:
        args.ImageFileName = imageFileName;

        // 2 - إنشاء دفق مخصص لملف الصورة الناتج:
        args.ImageStream = new FileStream(ArtifactsDir + imageFileName, FileMode.Create);

        Assert.True(args.ImageStream.CanWrite);
        Assert.True(args.IsImageAvailable);
        Assert.False(args.KeepImageStreamOpen);
    }

    private int mCount;
    private readonly string mOutFileName;
}

أنظر أيضا