CssSavingArgs

CssSavingArgs class

Fournit des données pour leCssSaving événement.

Pour en savoir plus, visitez leEnregistrer un document article documentaire.

public class CssSavingArgs

Propriétés

NomLa description
CssStream { get; set; }Permet de spécifier le flux dans lequel les informations CSS seront enregistrées.
Document { get; }Obtient l’objet document en cours d’enregistrement.
IsExportNeeded { get; set; }Permet de spécifier si le CSS sera exporté dans un fichier et intégré dans un document HTML. La valeur par défaut estvrai . Lorsque cette propriété estFAUX , les informations CSS ne seront pas enregistrées dans un fichier CSS et ne seront pas intégrées au document HTML.
KeepCssStreamOpen { get; set; }Spécifie si Aspose.Words doit garder le flux ouvert ou le fermer après avoir enregistré une information CSS.

Remarques

Par défaut, lorsque Aspose.Words enregistre un document au format HTML, il enregistre les informations CSS inline (en tant que valeur dustyle attribut sur chaque élément).

CssSavingArgspermet de sauvegarder les informations CSS dans un fichier en fournissant votre propre objet de flux.

Pour enregistrer le CSS dans le flux, utilisez leCssStream propriété.

Pour supprimer l’enregistrement du CSS dans un fichier et l’intégration dans un document HTML, utilisez l’optionIsExportNeeded propriété.

Exemples

Montre comment utiliser les feuilles de style CSS créées par une conversion HTML.

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

    // Crée un objet "HtmlFixedSaveOptions", que l'on peut passer à la méthode "Save" du document
    // pour modifier la façon dont nous convertissons le document en HTML.
    HtmlSaveOptions options = new HtmlSaveOptions();

    // Définissez la propriété "CssStylesheetType" sur "CssStyleSheetType.External" pour
    // accompagne un document HTML enregistré avec un fichier de feuille de style CSS externe.
    options.CssStyleSheetType = CssStyleSheetType.External;

    // Vous trouverez ci-dessous deux manières de spécifier des répertoires et des noms de fichiers pour les feuilles de style CSS de sortie.
    // 1 - Utilisez la propriété "CssStyleSheetFileName" pour attribuer un nom de fichier à notre feuille de style :
    options.CssStyleSheetFileName = ArtifactsDir + "SavingCallback.ExternalCssFilenames.css";

    // 2 - Utilisez un rappel personnalisé pour nommer notre feuille de style :
    options.CssSavingCallback =
        new CustomCssSavingCallback(ArtifactsDir + "SavingCallback.ExternalCssFilenames.css", true, false);

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

/// <summary>
/// Définit un nom de fichier personnalisé, ainsi que d'autres paramètres pour une feuille de style CSS externe.
/// </summary>
private class CustomCssSavingCallback : ICssSavingCallback
{
    public CustomCssSavingCallback(string cssDocFilename, bool isExportNeeded, bool keepCssStreamOpen)
    {
        mCssTextFileName = cssDocFilename;
        mIsExportNeeded = isExportNeeded;
        mKeepCssStreamOpen = keepCssStreamOpen;
    }

    public void CssSaving(CssSavingArgs args)
    {
        // On peut accéder à l'intégralité du document source via la propriété "Document".
        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;
}

Voir également