Как разработчик C#, вы можете легко программно преобразовывать файлы DOC или DOCX в HTML-страницы в своих приложениях .NET в облаке. Это может быть полезно при совместном использовании ваших документов Word в виде адаптивных HTML-страниц с соответствующими заинтересованными сторонами. В этой статье вы узнаете, как просматривать документы Word в виде HTML-страниц с помощью REST API на C#.
- REST API средства просмотра Word в HTML и пакет SDK для .NET
- Просмотр Word в виде HTML-страниц с помощью REST API в C#
- Рендеринг Word в HTML-страницы с параметрами рендеринга с использованием C#
- Преобразование Word в HTML с водяным знаком с использованием C#
REST API средства просмотра Word в HTML и пакет SDK для .NET
Для рендеринга файлов DOC или DOCX в HTML я буду использовать .NET SDK GroupDocs.Viewer Cloud API. Он позволяет программно отображать и просматривать все виды популярных форматов файлов документов и изображений, таких как Word, Excel, PDF, PowerPoint, Visio, Project, Outlook, JPG, PNG и т. д.
Вы можете установить GroupDocs.Viewer Cloud в свой проект Visual Studio из диспетчера пакетов NuGet или установить его с помощью следующей команды в консоли диспетчера пакетов:
Install-Package GroupDocs.Viewer-Cloud
Прежде чем приступить к выполнению шагов и доступных примеров кода, получите свой идентификатор клиента и секрет из панели. Получив идентификатор клиента и секрет, добавьте код, как показано ниже:
string MyClientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
string MyClientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
string MyStorage = "";
var configuration = new Configuration(MyClientId, MyClientSecret);
Просмотр документов Word в виде HTML-страниц с помощью REST API в C#
Вы можете просматривать документы Word как HTML-страницы в облаке, выполнив простые шаги, указанные ниже:
- Загрузить файл DOCX в облако
- Визуализировать Word в HTML с помощью C#
- Скачать отрендеренные HTML-страницы
Загрузить документ
Во-первых, загрузите файл DOCX в облако, используя приведенный ниже пример кода:
// инициализировать API
var apiInstance = new FileApi(configuration);
// Откройте файл в IOStream с локального диска/диска.
var fileStream = File.Open(@"C:\Files\Sample.docx", FileMode.Open);
// создать запрос на загрузку файла
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);
// загрузить файл
var response = apiInstance.UploadFile(request);
В результате загруженный файл DOCX будет доступен в разделе файлов вашей панели управления.
Рендеринг Word в HTML-страницы с использованием C#
Вы можете программно преобразовать документы Word в HTML-страницы, выполнив следующие действия:
- Создайте экземпляр ViewAPI
- Создайте экземпляр FileInfo
- Укажите путь к входному файлу
- Создайте экземпляр ViewOptions
- Назначьте FileInfo для ViewOptions
- Установите ViewFormat как «HTML»
- Создайте запрос на просмотр, вызвав метод CreateViewRequest с ViewOptions.
- Получите ответ, вызвав метод CreateView() с CreateViewRequest.
В следующем примере кода показано, как преобразовать документ Word в HTML-страницы с помощью REST API на C#.
// инициализировать API
var apiInstance = new ViewApi(configuration);
// путь к входному файлу
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";
// определить параметры просмотра
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML; // output view format
// создать запрос на просмотр
var request = new CreateViewRequest(viewOptions);
// создать представление
var response = apiInstance.CreateView(request);
Просмотр документов Word в виде HTML-страниц с помощью REST API на C#.
Загрузите визуализированные HTML-страницы
Приведенный выше пример кода сохранит обработанные HTML-страницы в облаке. Вы можете загрузить их, используя следующий пример кода:
// инициализировать API
var fileApi = new FileApi(configuration);
// сохранить все визуализированные HTML-страницы
foreach (var page in response.Pages)
{
// создать запрос на скачивание файла
var downloadFileRequest = new DownloadFileRequest(page.Path, MyStorage);
// Загрузка файла
var file = fileApi.DownloadFile(downloadFileRequest);
// сохранить файл в рабочем каталоге
using (var fileStream = System.IO.File.Create("C:\\Files\\" + page.Path))
{
file.Seek(0, SeekOrigin.Begin);
file.CopyTo(fileStream);
}
}
Рендеринг Word в HTML-страницы с параметрами рендеринга с использованием C#
Вы можете использовать определенные параметры рендеринга для программного рендеринга документов Word на HTML-страницы, выполнив следующие шаги:
- Создайте экземпляр ViewAPI
- Создайте экземпляр FileInfo
- Укажите путь к входному файлу
- Создайте экземпляр ViewOptions
- Назначьте FileInfo для ViewOptions
- Установите ViewFormat как «HTML»
- Создайте экземпляр RenderOptions
- Установите различные параметры рендеринга, такие как PagesToRender, RenderComments и т. д.
- Создайте запрос на просмотр, вызвав метод CreateViewRequest с ViewOptions.
- Получите ответ, вызвав метод CreateView() с CreateViewRequest.
В следующем примере кода показано, как преобразовать документ Word в HTML-страницы с параметрами рендеринга с помощью REST API на C#.
// инициализировать API
var apiInstance = new ViewApi(configuration);
// путь к входному файлу
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";
// определить параметры просмотра
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML; // output view format
// определить параметры рендеринга
viewOptions.RenderOptions = new RenderOptions
{
// визуализировать комментарии
RenderComments = true,
// отображать определенный диапазон страниц
StartPageNumber = 1,
CountPagesToRender = 2,
};
// создать запрос на просмотр
var request = new CreateViewRequest(viewOptions);
// создать представление
var response = apiInstance.CreateView(request);
Преобразование Word в HTML с водяным знаком с использованием C#
Вы можете добавить текст водяного знака при программном преобразовании документов Word в HTML, выполнив следующие действия:
- Создайте экземпляр ViewAPI
- Создайте экземпляр FileInfo
- Укажите путь к входному файлу
- Создайте экземпляр ViewOptions
- Назначьте FileInfo для ViewOptions
- Установите ViewFormat как «HTML»
- Определить параметр просмотра водяного знака
- Установите текст водяного знака, размер, цвет и положение
- Создайте запрос на просмотр, вызвав метод CreateViewRequest с ViewOptions.
- Получите ответ, вызвав метод CreateView() с CreateViewRequest.
В следующем примере кода показано, как добавить текст водяного знака на отображаемые HTML-страницы с помощью REST API на C#.
// инициализировать API
var apiInstance = new ViewApi(configuration);
// путь к входному файлу
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";
// определить параметры просмотра
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML; // output view format
// определить водяной знак
viewOptions.Watermark = new Watermark
{
Text = "This is a sample watermark!",
Size = 100,
Color = "Red",
Position = Watermark.PositionEnum.Diagonal
};
// создать запрос на просмотр
var request = new CreateViewRequest(viewOptions);
// создать представление
var response = apiInstance.CreateView(request);
Преобразование Word в HTML с водяным знаком с использованием C#.
Попробуйте онлайн
Пожалуйста, попробуйте следующий бесплатный онлайн-инструмент рендеринга Word, разработанный с использованием вышеуказанного API. https://products.groupdocs.app/viewer/docx
Заключение
В этой статье вы узнали, как просматривать документы Word в виде HTML-страниц в облаке. Вы также узнали, как преобразовать Word в HTML с параметрами рендеринга в C#. Кроме того, вы узнали, как добавить текстовый водяной знак к визуализируемым HTML-страницам программно с помощью C#. Кроме того, вы узнали, как программно загрузить файл DOCX в облако, а затем загрузить из облака обработанные HTML-файлы. Вы можете узнать больше об облачном API GroupDocs.Viewer, используя документацию. Мы также предоставляем раздел Справочник по API, который позволяет визуализировать наши API и взаимодействовать с ними непосредственно через браузер. В случае возникновения каких-либо неясностей, пожалуйста, свяжитесь с нами на форуме.