الفئة HtmlSaveOptions

HtmlSaveOptions class

يسمح بتحديد خيارات إضافية عند حفظ المستند بتنسيق HTML.

public class HtmlSaveOptions : SaveOptions

المُنشئات

الاسمالوصف
HtmlSaveOptions()البناء الافتراضي.

الخصائص

الاسمالوصف
CssPerPageGeneration { get; set; }يحصل أو يعيّن ما إذا كان سيتم إنشاء ملف StyleSheet لكل صفحة جديدة على حدة.
CssSavingCallback { get; set; }يحصل أو يعيّن الدالة الراجعة التي تُستدعى لإنشاء مورد لتخزين CSS.
DocumentPerPageGeneration { get; set; }يحصل أو يعيّن قيمة تشير إلى ما إذا كان توليد مستند لكل صفحة مفعلاً.
ExportCss { get; set; }يحصل أو يعيّن طريقة تصدير css.
ExportFonts { get; set; }يحصل أو يعيّن طريقة تصدير الخطوط.
ExportImages { get; set; }يحصل أو يعيّن طريقة تصدير الصور.
FontFaceTypes { get; set; }يحصل أو يعيّن أنواع خطوط الواجهة.
FontSavingCallback { get; set; }يحصل أو يعيّن الدالة الراجعة التي تُستدعى لإنشاء مورد لتخزين الخط.
FontsSubsystem { get; set; }يحصل أو يضبط إعدادات الخط التي سيتم استخدامها أثناء الحفظ
ImageSavingCallback { get; set; }يحصل أو يضبط رد النداء الذي يتم استدعاؤه لإنشاء مورد لتخزين الصورة.
PageCount { get; set; }يحصل أو يضبط عدد الصفحات التي سيتم حفظها. القيمة الافتراضية هي MaxValue مما يعني أنه سيتم عرض جميع صفحات المستند.
PageIndex { get; set; }يحصل أو يضبط فهرس الصفحة الأولى التي سيتم حفظها. القيمة الافتراضية هي 0.
PageSavingCallback { get; set; }يحصل أو يضبط رد النداء الذي يتم استدعاؤه لإنشاء مورد لتخزين الصفحة.
SaveFormat { get; }يحصل على الصيغة التي يُحفظ بها المستند.

أمثلة

يظهر كيفية حفظ مستند بتنسيق html مع تخزين جميع الموارد (css/خطوط/صور) في ملفات منفصلة.

string dataDir = RunExamples.GetDataDir_LoadingAndSaving();
var document = new Document(Path.Combine(dataDir, "Aspose.one"));

var options = new HtmlSaveOptions()
             {
                 ExportCss = ResourceExportType.ExportAsStream,
                 ExportFonts = ResourceExportType.ExportAsStream,
                 ExportImages = ResourceExportType.ExportAsStream,
                 FontFaceTypes = FontFaceType.Ttf
             };
document.Save(dataDir + "document_out.html", options);

يظهر كيفية حفظ مستند إلى تدفق بتنسيق html مع تضمين جميع الموارد (css/خطوط/صور).

string dataDir = RunExamples.GetDataDir_LoadingAndSaving();
var document = new Document(Path.Combine(dataDir, "Aspose.one"));

var options = new HtmlSaveOptions()
             {
                 ExportCss = ResourceExportType.ExportEmbedded,
                 ExportFonts = ResourceExportType.ExportEmbedded,
                 ExportImages = ResourceExportType.ExportEmbedded,
                 FontFaceTypes = FontFaceType.Ttf
             };

var r = new MemoryStream();
document.Save(r, options);

يوضح كيفية إنشاء مستند وحفظه بتنسيق html لنطاق محدد من الصفحات.

// المسار إلى دليل المستندات.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();

// تهيئة مستند OneNote.
Document doc = new Document();

Page page = doc.AppendChildLast(new Page());

// النمط الافتراضي لجميع النصوص في المستند.
ParagraphStyle textStyle = new ParagraphStyle { FontColor = Color.Black, FontName = "Arial", FontSize = 10 };
page.Title = new Title()
             {
                 TitleText = new RichText() { Text = "Title text.", ParagraphStyle = textStyle },
                 TitleDate = new RichText() { Text = new DateTime(2011, 11, 11).ToString("D", CultureInfo.InvariantCulture), ParagraphStyle = textStyle },
                 TitleTime = new RichText() { Text = "12:34", ParagraphStyle = textStyle }
             };

// حفظ بتنسيق HTML
dataDir = dataDir + "CreateAndSavePageRange_out.html";
doc.Save(dataDir, new HtmlSaveOptions
                  {
                      PageCount = 1,
                      PageIndex = 0
                  });

يظهر كيفية حفظ مستند بتنسيق HTML مع تخزين جميع الموارد (css/خطوط/صور) باستخدام ردود نداء معرفة من قبل المستخدم.

// الكود أدناه ينشئ مجلد 'documentFolder' يحتوي على document.html، ومجلد 'css' به ملف 'style.css'، ومجلد 'images' يحتوي على صور، ومجلد 'fonts' يحتوي على خطوط.
// 'style.css' سيحتوي في النهاية على السلسلة التالية "/* This line is appended to stream manually by user */"
var savingCallbacks = new UserSavingCallbacks()
                          {
                              RootFolder = "documentFolder",
                              CssFolder = "css",
                              KeepCssStreamOpened = true,
                              ImagesFolder = "images",
                              FontsFolder = "fonts"
                          };
var options = new HtmlSaveOptions
              {
                  FontFaceTypes = FontFaceType.Ttf,
                  CssSavingCallback = savingCallbacks,
                  FontSavingCallback = savingCallbacks,
                  ImageSavingCallback = savingCallbacks
              };

if (!Directory.Exists(savingCallbacks.RootFolder))
{
    Directory.CreateDirectory(savingCallbacks.RootFolder);
}

string dataDir = RunExamples.GetDataDir_LoadingAndSaving();
var document = new Document(Path.Combine(dataDir, "Aspose.one"));

using (var stream = File.Create(Path.Combine(savingCallbacks.RootFolder, "document.html")))
{
    document.Save(stream, options);
}

using (var writer = new StreamWriter(savingCallbacks.CssStream))
{
    writer.WriteLine();
    writer.WriteLine("/* This line is appended to stream manually by user */");
}

انظر أيضًا