CssSavingArgs

CssSavingArgs class

يوفر بيانات لـCssSaving الحدث.

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

public class CssSavingArgs

الخصائص

اسموصف
CssStream { get; set; }يسمح بتحديد الدفق الذي سيتم حفظ معلومات CSS فيه.
Document { get; }يحصل على كائن المستند الذي يتم حفظه حاليًا.
IsExportNeeded { get; set; }يسمح بتحديد ما إذا كان سيتم تصدير CSS إلى ملف ودمجه في مستند HTML. الإعداد الافتراضي هوحقيقي . عندما تكون هذه الخاصيةخطأ شنيع لن يتم حفظ معلومات CSS في ملف CSS ولن يتم تضمينها في مستند HTML.
KeepCssStreamOpen { get; set; }يحدد ما إذا كان يجب على Aspose.Words إبقاء الدفق مفتوحًا أو إغلاقه بعد حفظ معلومات CSS.

ملاحظات

بشكل افتراضي، عندما يحفظ Aspose.Words مستندًا إلى HTML، فإنه يحفظ معلومات CSS inline (كقيمة لـأسلوب السمة على كل عنصر).

CssSavingArgs يسمح بحفظ معلومات CSS في ملف من خلال توفير كائن التدفق الخاص بك.

لحفظ CSS في التدفق، استخدمCssStream ملكية.

لمنع حفظ CSS في ملف وتضمينه في مستند HTML، استخدمIsExportNeeded ملكية.

أمثلة

يوضح كيفية العمل مع أوراق أنماط CSS التي ينشئها تحويل HTML.

public void ExternalCssFilenames()
{
    Document doc = new Document(MyDir + "Rendering.docx");

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

    // اضبط خاصية "CssStylesheetType" إلى "CssStyleSheetType.External"
    // قم بإرفاق مستند HTML المحفوظ بملف جدول أنماط CSS خارجي.
    options.CssStyleSheetType = CssStyleSheetType.External;

    // فيما يلي طريقتان لتحديد الدلائل وأسماء الملفات لأوراق أنماط CSS الناتجة.
    // 1 - استخدم خاصية "CssStyleSheetFileName" لتعيين اسم ملف لورقة الأنماط الخاصة بنا:
    options.CssStyleSheetFileName = ArtifactsDir + "SavingCallback.ExternalCssFilenames.css";

    // 2 - استخدم استدعاء مخصص لتسمية ورقة الأنماط الخاصة بنا:
    options.CssSavingCallback =
        new CustomCssSavingCallback(ArtifactsDir + "SavingCallback.ExternalCssFilenames.css", true, false);

    doc.Save(ArtifactsDir + "SavingCallback.ExternalCssFilenames.html", options);
}

/// <summary>
/// تعيين اسم ملف مخصص، إلى جانب معلمات أخرى لنمط CSS الخارجي.
/// </summary>
private class CustomCssSavingCallback : ICssSavingCallback
{
    public CustomCssSavingCallback(string cssDocFilename, bool isExportNeeded, bool keepCssStreamOpen)
    {
        mCssTextFileName = cssDocFilename;
        mIsExportNeeded = isExportNeeded;
        mKeepCssStreamOpen = keepCssStreamOpen;
    }

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

        args.CssStream = new FileStream(mCssTextFileName, FileMode.Create);
        args.IsExportNeeded = mIsExportNeeded;
        args.KeepCssStreamOpen = mKeepCssStreamOpen;

        Assert.True(args.CssStream.CanWrite);
    }

    private readonly string mCssTextFileName;
    private readonly bool mIsExportNeeded;
    private readonly bool mKeepCssStreamOpen;
}

أنظر أيضا