Class HtmlSaveOptions

نام ها : Aspose.Words.Saving جمع آوری: WL26_.dll (25.4.0)

می تواند برای مشخص کردن گزینه های اضافی در هنگام ذخیره یک سند دردانلود نرم افزار Aspose.Words.SaveFormat.Html، Aspose.Words.SaveFormat.Mhtml، Aspose.Words.SaveFormat.Epubفرمت Aspose.Words.SaveFormat.Azw3 یا Aspose.Words.SaveFormat.Mobi.

برای کسب اطلاعات بیشتر، به سایت مراجعه کنید Specify Save Options مقاله مستندات

public class HtmlSaveOptions : SaveOptions

Inheritance

object ← SaveOptions ← HtmlSaveOptions

اعضای ارثی

SaveOptions.CreateSaveOptions(SaveFormat) , SaveOptions.CreateSaveOptions(string) , SaveOptions.SaveFormat , SaveOptions.ExportGeneratorName , SaveOptions.TempFolder , SaveOptions.PrettyFormat , SaveOptions.UseAntiAliasing , SaveOptions.UseHighQualityRendering , SaveOptions.DmlRenderingMode , SaveOptions.DmlEffectsRenderingMode , SaveOptions.ImlRenderingMode , SaveOptions.DefaultTemplate , SaveOptions.UpdateFields , SaveOptions.UpdateLastSavedTimeProperty , SaveOptions.UpdateLastPrintedProperty , SaveOptions.UpdateCreatedTimeProperty , SaveOptions.MemoryOptimization , SaveOptions.UpdateAmbiguousTextFont , SaveOptions.Dml3DEffectsRenderingMode , SaveOptions.ProgressCallback , SaveOptions.AllowEmbeddingPostScriptFonts , SaveOptions.CustomTimeZoneInfo , object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

HtmlSaveOptions()

یک مثال جدید از این کلاس را آغاز می کند که می تواند برای ذخیره یک سند استفاده شود.در فرمت Aspose.Words.SaveFormat.Html

public HtmlSaveOptions()

HtmlSaveOptions(SaveFormat)

یک مثال جدید از این کلاس را آغاز می کند که می تواند برای ذخیره یک سند استفاده شود.در Aspose.Words.SaveFormat.Html، Aspose.Words.SaveFormat.Mhtml، Aspose.Words.SaveFormat.Epub،فرمت Aspose.Words.SaveFormat.Azw3 یا Aspose.Words.SaveFormat.Mobi.

public HtmlSaveOptions(SaveFormat saveFormat)

Parameters

saveFormat SaveFormat

می تواند Aspose.Words.SaveFormat.Html، Aspose.Words.SaveFormat.Mhtml، Aspose.Words.SaveFormat.Epub،دانلود نرم افزار Aspose.Words.SaveFormat.Azw3 یا Aspose.Words.SaveFormat.Mobi

Properties

AllowNegativeIndent

مشخص می کند که آیا شاخص های منفی چپ و راست پاراگراف ها به حالت عادی شده استدر هنگام ذخیره به HTML، MHTML یا EPUB.

public bool AllowNegativeIndent { get; set; }

ارزش املاک

bool

Remarks

هنگامی که شاخص منفی مجاز نیست، آن را به عنوان شاخص صفر به HTML صادر می شود. هنگامی که شاخص منفی مجاز است، یک پاراگراف ممکن است به طور جزئی خارج از پنجره مرورگر ظاهر شود.

CssClassNamePrefix

یک پیش فرض را مشخص می کند که به تمام نام های کلاس CSS اضافه می شود.ارزش پیش فرض یک نوار خالی است و نام های کلاس CSS تولید شده هیچ پیش فرض مشترک ندارند.

public string CssClassNamePrefix { get; set; }

ارزش املاک

string

Remarks

اگر این مقدار خالی نباشد، تمام کلاس های CSS تولید شده توسط Aspose.Words با پیش فرض مشخص شده شروع می شود.این ممکن است مفید باشد، به عنوان مثال، اگر شما CSS سفارشی را به اسناد تولید شده اضافه کنید و می خواهید از اختلافات نام کلاس جلوگیری کنید.

اگر ارزش خالی نباشد یا خالی باشد، باید یک شناسه CSS معتبر باشد.

Exceptions

ArgumentException

ارزش خالی نیست و یک شناسه CSS معتبر نیست.

CssSavingCallback

اجازه می دهد تا کنترل کنید که چگونه سبک های CSS ذخیره می شوند زمانی که یک سند به HTML، MHTML یا EPUB ذخیره می شود.

public ICssSavingCallback CssSavingCallback { get; set; }

ارزش املاک

ICssSavingCallback

CssStyleSheetFileName

مشخص مسیر و نام فایل Cascading Style Sheet (CSS) نوشته شده هنگامی که یک سندبه HTML وارد می شود.فرض یک ردیف خالی است.

public string CssStyleSheetFileName { get; set; }

ارزش املاک

string

Remarks

این ویژگی تنها زمانی موثر است که یک سند را به فرمت HTML ذخیره کنید و یک صفحه سبک CSS خارجی با استفاده از Aspose.Words.Saving.HtmlSaveOptions.CssStyleSheetType درخواست می شود.

اگر این ویژگی خالی باشد، فایل CSS در همان پوشه و با همان نام به عنوان سند HTML ذخیره می شود اما با افزونه “css” ذخیره می شود.

اگر فقط مسیر اما هیچ نام فایل در این ویژگی مشخص نشده است، فایل CSS در پوشه مشخص شده ذخیره می شود و همان نام را به عنوان سند HTML اما با افزونه “css” خواهد داشت.

اگر پوشه مشخص شده توسط این ویژگی وجود ندارد، آن را به طور خودکار ایجاد می شود قبل از فایل CSS ذخیره می شود.

راه دیگری برای مشخص کردن یک پوشه که در آن فایل CSS خارجی ذخیره می شود، استفاده از Aspose.Words.Saving.HtmlSaveOptions.ResourceFolder است.

Aspose.Words.Saving.HtmlSaveOptions.ResourceFolder Aspose.Words.Saving.HtmlSaveOptions.ResourceFolderAlias Aspose.Words.Saving.HtmlSaveOptions.CssStyleSheetType

CssStyleSheetType

مشخص می کند که چگونه CSS (Cascading Style Sheet) سبک ها به HTML، MHTML یا EPUB صادر می شود.ارزش پیش فرض Aspose.Words.Saving.CssStyleSheetType.Inline برای HTML/MHTML وبایگانی برچسب ها: CssStyleSheetType.External برای EPUB

public CssStyleSheetType CssStyleSheetType { get; set; }

ارزش املاک

CssStyleSheetType

Remarks

هنگامی که شما در حال صادرات به یکی از فرمت های کانتینر (EPUB یا MHTML) و مشخص کردن Aspose.Words.Saving.CssStyleSheetType.External، فایل CSS در بسته خروجی کپسول خواهد شد.

همچنین ببینید

HtmlSaveOptions . CssStyleSheetFileName

DocumentPartSavingCallback

اجازه می دهد تا کنترل کنید که چگونه قطعات اسناد ذخیره می شوند زمانی که یک اسناد به HTML یا EPUB ذخیره می شود.

public IDocumentPartSavingCallback DocumentPartSavingCallback { get; set; }

ارزش املاک

IDocumentPartSavingCallback

DocumentSplitCriteria

مشخص می کند که چگونه اسناد باید در هنگام ذخیره به Aspose.Words.SaveFormat.Html تقسیم شود،فرمت Aspose.Words.SaveFormat.Epub یا Aspose.Words.SaveFormat.Azw3به طور پیش فرض Aspose.Words.Saving.DocumentSplitCriteria.None برای HTML وAspose.Words.Saving.DocumentSplitCriteria.Heading پاراگراف برای EPUB و AZW3.

public DocumentSplitCriteria DocumentSplitCriteria { get; set; }

ارزش املاک

DocumentSplitCriteria

Remarks

به طور معمول شما می خواهید یک سند ذخیره شده به HTML به عنوان یک فایل واحد. اما در برخی از موارد آن را ترجیح می دهد برای تقسیم خروجی به چند صفحه کوچک تر HTML. هنگامی که پس انداز به فرمت HTML این صفحات خواهد بود خروج به فایل های فردی و یا جریان.

یک سند نمی تواند در هنگام ذخیره سازی در فرمت MHTML تقسیم شود.

Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitHeadingLevel Aspose.Words.Saving.HtmlSaveOptions.DocumentPartSavingCallback

DocumentSplitHeadingLevel

حداکثر سطح عنوان را مشخص می کند که در آن باید اسناد را تقسیم کنید.قیمت پیش فرض “2” است.

public int DocumentSplitHeadingLevel { get; set; }

ارزش املاک

int

Remarks

هنگامی که Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitCriteria شامل _ www.Wl26_.Removing.document Platform.HeadingParagraph و این ویژگی به یک مقدار از 1 تا 9 تنظیم شده است، اسناد به پاراگراف های فرمت شده با استفاده از ، ، و غیره استایل ها تا سطح عنوان مشخص شده تقسیم می شود.

به طور پیش فرض، فقط و پاراگراف ها باعث می شود که سند تقسیم شود. قرار دادن این دارایی به صفر منجر به آن خواهد شد که اسناد به عنوان بندها به هیچ وجه تقسیم نشوند.

Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitCriteria Aspose.Words.Saving.HtmlSaveOptions.DocumentPartSavingCallback

Encoding

کدگذاری برای استفاده در هنگام صادرات به HTML، MHTML یا EPUB مشخص می شود.قیمت پیش فرض " UTF8Encoding(false)" (UTF-8 بدون BOM) است.

public Encoding Encoding { get; set; }

ارزش املاک

Encoding

ExportCidUrlsForMhtmlResources

مشخص می کند که آیا باید از URL های CID (Content-ID) برای منابع مرجع (تصویر، فونت ها، CSS) در اسناد MHTML استفاده شود.

public bool ExportCidUrlsForMhtmlResources { get; set; }

ارزش املاک

bool

Remarks

این گزینه فقط بر اسناد ذخیره شده در MHTML تاثیر می گذارد.

به طور پیش فرض، منابع در اسناد MHTML با نام فایل (به عنوان مثال، “image.png”) اشاره می شود که با عنوان های “محتوا-موقعیت” بخش های MIME مطابقت دارد.

این گزینه یک روش جایگزین را فراهم می کند، که در آن مرجع به فایل های منبع به عنوان URL های CID (Content-ID) نوشته می شود (به عنوان مثال، “cid:image.png”) و با عنوان های “Content-ID” مطابقت دارد.

در تئوری، هیچ تفاوتی بین دو روش مرجع وجود ندارد و هر یک از آنها باید در هر مرورگر یا آژانس ایمیل کار کند.در عمل، با این حال، برخی از آژانس ها نتوانند منابع را با نام فایل جمع آوری کنند.اگر مرورگر یا آژانس ایمیل شما از بارگذاری منابع موجود در یک سند MTHML امتناع می کند (تصویرها را نشان نمی دهد یا سبک های CSS را بار نمی دهد)، سعی کنید این سند را با URL های CID صادر کنید.

ExportDocumentProperties

مشخص می کند که آیا برای صادرات ویژگی های مستند ساخته شده و سفارشی به HTML، MHTML یا EPUB.قیمت پیش فرض جعلی است.

public bool ExportDocumentProperties { get; set; }

ارزش املاک

bool

ExportDropDownFormFieldAsText

کنترل چگونگی ذخیره کردن فیلدها به HTML یا MHTML.قیمت پیش فرض جعلی است.

public bool ExportDropDownFormFieldAsText { get; set; }

ارزش املاک

bool

Remarks

هنگامی که تنظیم می شود، فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت فرمت

هنگامی که به EPUB صادر می شود، زمینه های فرم فرستادن متن همیشه به دلیل نیازهای این فرمت به عنوان متن ذخیره می شوند.

ExportFontResources

مشخص می کند که آیا منابع فونت باید به HTML، MHTML یا EPUB صادر شود.Default ‘fake’ است.

public bool ExportFontResources { get; set; }

ارزش املاک

bool

Remarks

<p>Exporting font resources allows for consistent document rendering independent of the fonts available
         in a given user's environment.</p>

اگر Aspose.Words.Saving.HtmlSaveOptions.ExportFontResources به تنظیم شده است، سند اصلی HTML به هر فونت از طریق CSS 3 به طور معمول اشاره می کند و فاکتورها به عنوان فایل های جداگانه خروجی می شوند.

اگر Aspose.Words.Saving.HtmlSaveOptions.ExportFontsAsBase64 تنظیم شده است ، فونت ها به فایل های جداگانه ذخیره نمی شود.

در هنگام صادرات منابع فونت، مسائل مربوط به مجوز کردن فاکتورها باید در نظر گرفته شود. نویسندگان که می خواهند از طریق یک مکانیزم فرمت قابل دانلود استفاده کنند، باید همیشه با دقت بررسی کنند که استفاده مورد نظر آنها در محدوده گواهینامه اسناد قرار دارد. بسیاری از اسلات تجاری در حال حاضر اجازه نمی دهند که از هر شکل از آن ها به صورت وب دانلود شوند. موافقت نامه های مرخصی که برخی از آنها را پوشش می دهند، به طور خاص یادآوری می کند که این استفاده از قوانین در صفحات سبک CSS مجاز نیست.

Aspose.Words.Saving.HtmlSaveOptions.FontResourcesتغییرمسیر

ExportFontsAsBase64

مشخص می کند که آیا منابع فونت باید در HTML در Base64 رمزگذاری شده باشد.Default ‘fake’ است.

public bool ExportFontsAsBase64 { get; set; }

ارزش املاک

bool

Remarks

به طور پیش فرض، فونت ها به فایل های جداگانه نوشته می شوند.اگر این گزینه تنظیم شود، فونت ها در CSS سند در رمزگذاری Base64 قرار می گیرند.

ExportHeadersFootersMode

مشخص می کند که چگونه سر و پاها به HTML، MHTML یا EPUB می رسند.ارزش پیش فرض Aspose.Words.Saving.ExportHeadersFootersMode.PerSection برای HTML/MHTML استو Aspose.Words.Saving.ExportHeadersFootersMode.None برای EPUB.

public ExportHeadersFootersMode ExportHeadersFootersMode { get; set; }

ارزش املاک

ExportHeadersFootersMode

Remarks

سخت است که به طور معنی دار عنوان ها و پاها را به HTML وارد کنید زیرا HTML صفحه نشده است.

هنگامی که این دارایی Aspose.Words.Saving.ExportHeadersFootersMode.PerSection است، Aspose.Words تنها در ابتدای و پایان هر بخش، سرها و پاها اصلی را صادر می کند.

هنگامی که Aspose.Words.Saving.ExportHeadersFootersMode.FirstSectionHeaderLastSectFooter تنها اولین عنوان اصلی و آخرین پایه اصلی (از جمله مرتبط با قبلی) صادر می شود.

شما می توانید با تنظیم این ویژگی به Aspose.Words.Saving.ExportHeadersFootersMode.None، صادرات سرها و پاها را غیرفعال کنید.

ExportImagesAsBase64

مشخص می کند که آیا تصاویر در فرمت Base64 به خروجی HTML، MHTML یا EPUB ذخیره می شوند.

public bool ExportImagesAsBase64 { get; set; }

ارزش املاک

bool

Remarks

هنگامی که این ویژگی به تصاویر تنظیم می شود، داده ها به طور مستقیم به عناصر صادر می شوند و فایل های جداگانه ایجاد نمی شوند.

ExportLanguageInformation

مشخص می کند که آیا اطلاعات زبان به HTML، MHTML یا EPUB صادر می شود.به طور پیش فرض “دروغ” است.

public bool ExportLanguageInformation { get; set; }

ارزش املاک

bool

Remarks

هنگامی که این ویژگی به Aspose.Words تنظیم می شود، خروجی ویژگی HTML بر روی عناصر اسناد که زبان را مشخص می کنند.این ممکن است برای حفظ زبان مرتبط با سمانتیک مورد نیاز باشد.

ExportListLabels

بررسی چگونگی خروجی برچسب های لیست به HTML، MHTML یا EPUB.ارزش پیش فرض Aspose.Words.Saving.ExportListLabels.Auto است.

public ExportListLabels ExportListLabels { get; set; }

ارزش املاک

ExportListLabels

ExportOriginalUrlForLinkedImages

مشخص می کند که آیا URL اصلی باید به عنوان URL از تصاویر مرتبط استفاده شود.قیمت پیش فرض جعلی است.

public bool ExportOriginalUrlForLinkedImages { get; set; }

ارزش املاک

bool

Remarks

اگر ارزش به Aspose.Words.Drawing.ImageData.SourceFullName ارزش به عنوان URL از تصاویر مرتبط استفاده می شود و تصاویر مرتبط به پوشه اسناد یا Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder بارگذاری نمی شود.

اگر مقدار به تصاویر مرتبط تنظیم می شود، در پوشه سند یا Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder و URL هر تصویر مرتبط بسته به پوشاک سند ساخته شده است، www.Wl26.Give.Thumbs.

ExportPageMargins

مشخص می کند که آیا مارجین های صفحه به HTML، MHTML یا EPUB صادر می شود.Default جعلی است.

public bool ExportPageMargins { get; set; }

ارزش املاک

bool

Remarks

Aspose.Words به طور پیش فرض فضای صفحات را نشان نمی دهد.اگر برخی از عناصر به طور کامل یا جزئی توسط محدوده اسناد پوشیده شوند، می توان منطقه نمایش داده شده را بااین گزینه

ExportPageSetup

مشخص می کند که آیا تنظیمات صفحه به HTML، MHTML یا EPUB صادر می شود.به طور پیش فرض جعلی است.

public bool ExportPageSetup { get; set; }

ارزش املاک

bool

Remarks

هر Aspose.Words.Section در Aspose.Words مدل اسناد ارائه می دهد اطلاعات تنظیم صفحه از طریق کلاس Aspose.Words.PageSetup. هنگامی که شما یک اسناد به فرمت HTML شما ممکن است نیاز به نگه داشتن این اطلاعات برای استفاده بیشتر. به طور خاص، تنظیم صفحه ممکن است مهم برای ارائه به رسانه های پگ (نمایش) و یا پس از آن تبدیل به فرمت های فایل مایکروسافت Word بومی (DOCX، DOC، RTF، WML).

در اکثر موارد HTML برای مشاهده در مرورگرها که در آن صفحه نمایش انجام نمی شود طراحی شده است، بنابراین این ویژگی به طور پیش فرض غیرفعال است.

ExportRelativeFontSize

مشخص می کند که آیا اندازه های فونت باید خروجی در واحد های نسبی در هنگام ذخیره به HTML، MHTML یا EPUB باشد.

public bool ExportRelativeFontSize { get; set; }

ارزش املاک

bool

Remarks

در بسیاری از اسناد موجود (HTML، IDPF EPUB) اندازه های فونت در واحد های نسبی مشخص شده است. این اجازه می دهد تا برنامه ها برای تنظیم اندازه متن در هنگام مشاهده / پردازش فایل ها. به عنوان مثال، مایکروسافت اینترنت اکسپلورر دارای زیر منوی “نگاه کنید->حجم متن”، Adobe Digital Editions دارای دو دکمه: افزایش / کاهش حجم متن. اگر شما انتظار این ویژگی برای کار پس از آن تنظیم Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize ویژگی به .

WL51_ الگوی اسناد کلمات حاوی و تنها با واحد اندازه فونت مطلق کار می کند. واحد های نسبی نیاز به منطق اضافی برای محاسبه از برخی از اندازه های اولیه (معیاری) است. اندازه فاکتور از سبک سند به عنوان استاندارد گرفته می شود.

هنگامی که این گزینه فعال می شود، عناصر اسناد غیر از متن هنوز هم دارای اندازه مطلق خواهد بود. همچنین برخی از ویژگی های مرتبط با متن ممکن است به طور کامل بیان شده است. به ویژه، خط فضایی مشخص شده با “واقعی” قاعده می تواند نتایج ناخواسته در هنگام مقیاس متن تولید. بنابراین سند منبع باید به درستی طراحی و آزمایش زمانی که صادرات با Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize تنظیم شده به .

ExportRoundtripInformation

مشخص می کند که آیا برای نوشتن اطلاعات حلقه در هنگام ذخیره به HTML، MHTML یا EPUB.قیمت پیش فرض “واقعی” برای HTML و “واقعی” برای MHTML و EPUB است.

public bool ExportRoundtripInformation { get; set; }

ارزش املاک

bool

Remarks

صرفه جویی در اطلاعات چرخش اجازه می دهد تا برای بازگرداندن ویژگی های اسناد مانند توقف صفحه، نظرات، عنوان ها و پاها در طول اسناد HTML بارگذاری مجدد به یک Aspose.Words.Document اشیاء.

هنگامی که اطلاعات چرخش چرخش به عنوان ویژگی های CSS از عناصر HTML مربوطه صادر می شود.

هنگامی که ، باعث نمی شود هیچ اطلاعات چرخش به خروجی به فایل های تولید شده.

ExportShapesAsSvg

بررسی می کند که آیا گره های Aspose.Words.Drawing.Shape در هنگام ذخیره به HTML، MHTML، EPUB یا AZW3 به تصاویر SVG تبدیل می شوند.

public bool ExportShapesAsSvg { get; set; }

ارزش املاک

bool

Remarks

اگر این گزینه تنظیم شده باشد، WL26_.Drawing.Shape گره ها به عنوان عناصروارد می شود.

ExportTextInputFormFieldAsText

کنترل می کند که چگونه زمینه های فرم ورودی متن به HTML یا MHTML ذخیره می شوند.قیمت پیش فرض جعلی است.

publicboolExportTextInputFormFieldAsText{get;set;}