PageSavingArgs

PageSavingArgs class

Предоставляет данные дляPageSaving событие.

Чтобы узнать больше, посетитеПрограммирование с документами статья документации.

public class PageSavingArgs

Конструкторы

ИмяОписание
PageSavingArgs()Конструктор по умолчанию.

Характеристики

ИмяОписание
KeepPageStreamOpen { get; set; }Указывает, должен ли Aspose.Words сохранять поток открытым или закрывать его после сохранения страницы документа.
PageFileName { get; set; }Получает или задает имя файла, в котором будет сохранена страница документа.
PageIndex { get; }Индекс текущей страницы.
PageStream { get; set; }Позволяет указать поток, в котором будет сохранена страница документа.

Примеры

Показывает, как использовать обратный вызов для сохранения документа в формате HTML постранично.

public void PageFileNames()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    builder.Writeln("Page 1.");
    builder.InsertBreak(BreakType.PageBreak);
    builder.Writeln("Page 2.");
    builder.InsertImage(ImageDir + "Logo.jpg");
    builder.InsertBreak(BreakType.PageBreak);
    builder.Writeln("Page 3.");

    // Создаем объект HtmlFixedSaveOptions, который мы можем передать методу Save документа.
    // чтобы изменить способ преобразования документа в HTML.
    HtmlFixedSaveOptions htmlFixedSaveOptions = new HtmlFixedSaveOptions();

    // Мы сохраним каждую страницу этого документа в отдельный HTML-файл в локальной файловой системе.
    // Устанавливаем обратный вызов, который позволяет нам присваивать имя каждому выходному HTML-документу.
    htmlFixedSaveOptions.PageSavingCallback = new CustomFileNamePageSavingCallback();

    doc.Save(ArtifactsDir + "SavingCallback.PageFileNames.html", htmlFixedSaveOptions);

    string[] filePaths = Directory.GetFiles(ArtifactsDir).Where(
        s => s.StartsWith(ArtifactsDir + "SavingCallback.PageFileNames.Page_")).OrderBy(s => s).ToArray();

    Assert.AreEqual(3, filePaths.Length);
}

/// <summary>
/// Сохраняет все страницы в файл и каталог, указанные внутри.
/// </summary>
private class CustomFileNamePageSavingCallback : IPageSavingCallback
{
    public void PageSaving(PageSavingArgs args)
    {
        string outFileName = $"{ArtifactsDir}SavingCallback.PageFileNames.Page_{args.PageIndex}.html";

        // Ниже приведены два способа указать, где Aspose.Words будет сохранять каждую страницу документа.
        // 1 - Установить имя файла выходной страницы:
        args.PageFileName = outFileName;

        // 2 — Создать собственный поток для выходного файла страницы:
        args.PageStream = new FileStream(outFileName, FileMode.Create);

        Assert.False(args.KeepPageStreamOpen);
    }
}

Смотрите также