Конвертировать HTML в XPS на С#
XPS – это формат хранения и просмотра документов, разработанный Microsoft. Он имеет ряд преимуществ, которые поддерживают функции безопасности, такие как цифровые подписи для обеспечения большей безопасности документов и многое другое. Преобразование HTML в XPS часто требуется для установления ограниченного доступа к редактированию или копированию документов. Формат файла XPS обеспечивает управление правами доступа и позволяет создавать высококачественные документы для печати. Файлы XPS можно использовать для обмена документами, и вы можете быть уверены, что то, что вы видите на странице, совпадает с тем, что видят другие люди при использовании средства просмотра XPS.
Использование методов Converter.ConvertHTML() является наиболее распространенным способом преобразования HTML-кода в различные форматы. С помощью Aspose.HTML вы можете программно конвертировать HTML в формат XPS с полным контролем над широким диапазоном параметров конвертации. В этой статье вы найдете информацию о том, как преобразовать HTML в XPS с помощью методов ConvertHTML() класса Converter и как применить XpsSaveOptions и параметры ICreateStreamProvider.
Онлайн HTML Конвертер
Вы можете проверить функциональность Aspose.HTML API и конвертировать HTML в режиме реального времени. Пожалуйста, загрузите HTML из локальной файловой системы, выберите выходной формат и запустите пример. В примере параметры сохранения установлены по умолчанию. Вы сразу получите результат в виде отдельного файла.
Если вы хотите программно преобразовать HTML в XPS, давайте рассмотрим следующие примеры кода C#.
HTML в XPS одной строкой кода
Статические методы класса Converter в основном используются как самый простой способ преобразования HTML-кода в различные форматы. Вы можете преобразовать HTML в XPS в своем приложении C# буквально с помощью одной строки кода!
1// Convert HTML to XPS using C#
2
3// Invoke the ConvertHTML() method to convert the HTML code to XPS
4Converter.ConvertHTML(@"<h1>Convert HTML to XPS!</h1>", ".", new XpsSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.xps"));
Конвертировать HTML в XPS
Преобразование файла в другой формат методом ConvertHTML() представляет собой последовательность операций, среди которых загрузка и сохранение документа:
- Загрузите файл HTML с помощью класса HTMLDocument.
- Создайте новый объект XpsSaveOptions.
- Используйте метод ConvertHTML() класса Converter для сохранения HTML в виде файла XPS. Вам необходимо передать HTMLDocument, XpsSaveOptions и путь к выходному файлу методу ConvertHTML() для преобразования HTML в XPS.
Просмотрите следующий фрагмент кода C#, в котором показан процесс преобразования HTML в XPS с использованием Aspose.HTML for .NET.
1// Convert HTML to XPS in C#
2
3// Prepare a path to a source HTML file
4string documentPath = Path.Combine(DataDir, "canvas.html");
5
6// Prepare a path to save the converted file
7string savePath = Path.Combine(OutputDir, "canvas-output.xps");
8
9// Initialize an HTML document from the file
10using HTMLDocument document = new HTMLDocument(documentPath);
11
12// Initialize XpsSaveOptions
13XpsSaveOptions options = new XpsSaveOptions();
14
15// Convert HTML to XPS
16Converter.ConvertHTML(document, options, savePath);
Вы можете скачать полные примеры и файлы данных с GitHub.
Параметры Сохранения
Aspose.HTML позволяет конвертировать HTML в XPS, используя стандартные или пользовательские параметры сохранения. Использование XpsSaveOptions позволяет настроить процесс рендеринга. Вы можете указать размер страницы, поля, Css и т. д.
Property | Description |
---|---|
PageSetup | This property gets a page setup object and uses it for configuration output page-set. |
Css | Gets a CssOptions object which is used for configuration of CSS properties processing. |
BackgroundColor | This property sets the color that will fill the background of every page. By default, this property is Transparent. |
HorizontalResolution | Sets horizontal resolution for output images in pixels per inch. The default value is 300 dpi. |
VerticalResolution | Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi. |
Чтобы узнать больше о XpsSaveOptions, прочитайте статьи раздела Конвертеры тонкой настройки.
Конвертировать HTML в XPS с использованием XpsSaveOptions
Чтобы преобразовать HTML в XPS с указанием XpsSaveOptions, необходимо выполнить несколько шагов:1. Загрузите файл HTML с помощью одного из конструкторов HTMLDocument() класса HTMLDocument.
- Создайте новый объект XpsSaveOptions.
- Используйте метод ConvertHTML() класса Converter для сохранения HTML в виде файла PDF. Вам необходимо передать HTMLDocument, XpsSaveOptions и путь к выходному файлу методу ConvertHTML() для преобразования HTML в XPS.
В следующем примере показано, как использовать XpsSaveOptions и создать файл XPS с пользовательским размером страницы и цветом фона:
1// Convert HTML to XPS with custom settings using C#
2
3string documentPath = Path.Combine(OutputDir, "save-options.html");
4string savePath = Path.Combine(OutputDir, "save-options-output.xps");
5
6// Prepare HTML code and save it to a file
7string code = "<h1> XpsSaveOptions Class</h1>\r\n" +
8 "<p>Using XpsSaveOptions Class, you can programmatically apply a wide range of conversion parameters such as BackgroundColor, PageSetup, etc.</p>\r\n";
9
10File.WriteAllText(documentPath, code);
11
12// Initialize an HTML Document from the html file
13using HTMLDocument document = new HTMLDocument(documentPath);
14
15// Set up the page-size, margins and change the background color to AntiqueWhite
16XpsSaveOptions options = new XpsSaveOptions()
17{
18 BackgroundColor = System.Drawing.Color.AntiqueWhite
19};
20options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(Length.FromInches(4.9f), Length.FromInches(3.5f)), new Margin(30, 20, 10, 10));
21
22// Convert HTML to XPS
23Converter.ConvertHTML(document, options, savePath);
Класс XpsSaveOptions предоставляет множество свойств, которые дают вам полный контроль над широким спектром параметров и улучшают процесс преобразования HTML в формат XPS. В приведенном выше примере мы используем:
- Свойство
BackgroundColor
, задающее цвет, которым будет заполняться фон. По умолчанию BackgroundColor имеет значение Transparent; - Свойство
PageSetup
, указывающее размер страницы и поля.
Output Stream Providers
Если требуется сохранять файлы в удаленном хранилище (например, в облаке, базе данных и т. д.), вы можете реализовать ICreateStreamProvider для ручного управления процессом создания файла. Этот интерфейс разработан как объект обратного вызова для создания потока в начале документа/страницы (в зависимости от выходного формата) и освобождения ранее созданного потока после рендеринга документа/страницы.
Aspose.HTML for .NET предоставляет различные типы выходных форматов для операций рендеринга. Некоторые из этих форматов создают один выходной файл (например, PDF, XPS), другие создают несколько файлов (форматы изображений JPG, PNG и т. д.).
В приведенном ниже примере показано, как реализовать и использовать собственный MemoryStreamProvider в приложении:
1// Implement a custom MemoryStream provider for advanced control over HTML rendering output streams
2
3class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
4{
5 // List of MemoryStream objects created during the document rendering
6 public List<MemoryStream> Streams { get; } = new List<MemoryStream>();
7
8 public Stream GetStream(string name, string extension)
9 {
10 // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats
11 MemoryStream result = new MemoryStream();
12 Streams.Add(result);
13 return result;
14 }
15
16 public Stream GetStream(string name, string extension, int page)
17 {
18 // This method is called when the creation of multiple output streams are required. For instance, during the rendering HTML to list of image files (JPG, PNG, etc.)
19 MemoryStream result = new MemoryStream();
20 Streams.Add(result);
21 return result;
22 }
23
24 public void ReleaseStream(Stream stream)
25 {
26 // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
27 }
28
29 public void Dispose()
30 {
31 // Releasing resources
32 foreach (MemoryStream stream in Streams)
33 stream.Dispose();
34 }
35}
1// Convert HTML to XPS in C# using memory stream
2
3// Create an instance of MemoryStreamProvider
4using MemoryStreamProvider streamProvider = new MemoryStreamProvider();
5
6// Initialize an HTML document
7using HTMLDocument document = new HTMLDocument(@"<h1>Convert HTML to XPS File Format!</h1>", ".");
8
9// Convert HTML to XPS using MemoryStreamProvider
10Converter.ConvertHTML(document, new XpsSaveOptions(), streamProvider);
11
12// Get access to the memory stream that contains the result data
13MemoryStream memory = streamProvider.Streams.First();
14memory.Seek(0, SeekOrigin.Begin);
15
16// Flush the result data to the output file
17using (FileStream fs = File.Create(Path.Combine(OutputDir, "stream-provider.xps")))
18{
19 memory.CopyTo(fs);
20}
Вы можете скачать полные примеры и файлы данных с GitHub.
Aspose.HTML предлагает бесплатный онлайн Kонвертер HTML в XPS, который конвертирует HTML в XPS качественно, легко и быстро. Просто загрузите, конвертируйте свои файлы и получите результат за несколько секунд!