HtmlSaveOptions

HtmlSaveOptions class

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

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

public class HtmlSaveOptions : SaveOptions

المنشئون

اسموصف
HtmlSaveOptions()يقوم بتهيئة مثيل جديد لهذه الفئة التي يمكن استخدامها لحفظ document فيHtml تنسيق.
HtmlSaveOptions(SaveFormat)يقوم بتهيئة مثيل جديد لهذه الفئة التي يمكن استخدامها لحفظ document فيHtml ،Mhtml ،Epub ، Azw3 أو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; }يحدد المسار واسم ملف Cascading Style Sheet (CSS) المكتوب عند تصدير document إلى 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; }يحصل على قيمة تحدد كيفية عرض تأثيرات DrawingML أو يعينها.
DmlRenderingMode { get; set; }يحصل على قيمة تحدد كيفية عرض أشكال DrawingML أو يعينها.
DocumentPartSavingCallback { get; set; }يسمح بالتحكم في كيفية حفظ أجزاء المستند عند حفظ المستند بتنسيق HTML أو EPUB.
DocumentSplitCriteria { get; set; }يحدد كيفية تقسيم المستند عند الحفظ فيHtml ، Epub أوAzw3 التنسيق الافتراضي هوNone لـ HTML و HeadingParagraph لـ EPUB وAZW3.
DocumentSplitHeadingLevel { get; set; }يحدد الحد الأقصى لمستوى العناوين التي سيتم تقسيم المستند عندها. القيمة الافتراضية هي2 .
Encoding { get; set; }يحدد الترميز الذي سيتم استخدامه عند التصدير إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيترميز UTF8 الجديد (خطأ) (UTF-8 بدون BOM).
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 عند حفظ x000d_ إلى 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; }يتم استدعاؤها أثناء حفظ المستند وتقبل البيانات حول تقدم الحفظ.
RemoveJavaScriptFromLinks { get; set; }يحدد ما إذا كان سيتم إزالة JavaScript من الروابط. الافتراضي هوخطأ شنيع .
ReplaceBackslashWithYenSign { get; set; }يحدد ما إذا كان يجب استبدال أحرف الشرطة العكسية بعلامات الين. القيمة الافتراضية هيخطأ شنيع .
ResolveFontNames { get; set; }يحدد ما إذا كانت أسماء عائلة الخطوط المستخدمة في المستند يتم حلها واستبدالها وفقًا لـ FontSettings عند كتابتها بتنسيقات تعتمد على HTML.
ResourceFolder { get; set; }يُحدد مجلدًا فعليًا تُحفظ فيه جميع الموارد، مثل الصور والخطوط وCSS الخارجية، عند تصدير document إلى HTML. القيمة الافتراضية هي سلسلة فارغة.
ResourceFolderAlias { get; set; }يحدد اسم المجلد المستخدم لإنشاء عناوين URI لجميع الموارد المكتوبة في مستند HTML. الافتراضي هو سلسلة فارغة.
override SaveFormat { get; set; }يحدد التنسيق الذي سيتم حفظ المستند به إذا تم استخدام كائن خيارات الحفظ هذا. يمكن أن يكونHtml ،Mhtml ،Epub ، Azw3 أوMobi .
ScaleImageToShapeSize { get; set; }يحدد ما إذا كانت الصور يتم قياسها بواسطة Aspose.Words إلى حجم الشكل المحيط عند التصدير إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيحقيقي .
TableWidthOutputMode { get; set; }يتحكم في كيفية تصدير عرض الجدول والصف والخليّة إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيAll .
TempFolder { get; set; }يحدد المجلد للملفات المؤقتة المستخدمة عند الحفظ في ملف DOC أو DOCX. بشكل افتراضي، تكون هذه الخاصيةباطل ولا يتم استخدام أي ملفات مؤقتة.
UpdateAmbiguousTextFont { get; set; }يحدد ما إذا كانت سمات الخط ستتغير وفقًا لرمز الحرف المستخدم.
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"، والذي يمكننا تمريره إلى طريقة "Save" الخاصة بالمستند
    // لتعديل كيفية تحويل المستند إلى 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;
}

أنظر أيضا

HtmlOfficeMathOutputMode Enum HtmlVersion Enum