Переглядайте документи Word як HTML-сторінки за допомогою REST API у C#

Як розробник на C#, ви можете легко передавати файли DOC або DOCX на HTML-сторінки програмним шляхом у своїх програмах .NET у хмарі. Це може бути корисно для спільного використання документів Word як адаптивних HTML-сторінок із відповідними зацікавленими сторонами. У цій статті ви дізнаєтесь, як переглядати документи Word як сторінки HTML за допомогою REST API у C#.

Word to HTML Viewer REST API та .NET SDK

Для відтворення файлів 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 у хмару, використовуючи наведений нижче приклад коду:

// ініціалізувати 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#.

Переглядайте документи 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);

Перетворення слова в 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 у HTML із водяним знаком за допомогою C#.

Спробуйте онлайн

Будь ласка, спробуйте наведений нижче безкоштовний онлайн-інструмент відтворення Word, розроблений за допомогою вищезазначеного API. https://products.groupdocs.app/viewer/docx

Висновок

У цій статті ви дізналися, як переглядати документи Word як сторінки HTML у хмарі. Ви також дізналися, як відобразити Word у HTML із параметрами відтворення в C#. Крім того, ви навчилися програмно додавати водяний знак до відтворених HTML-сторінок за допомогою C#. Крім того, ви дізналися, як програмно завантажити файл DOCX у хмару, а потім завантажити відрендерені файли HTML із хмари. Ви можете дізнатися більше про GroupDocs.Viewer Cloud API, використовуючи документацію. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. У разі будь-яких неясностей зв’яжіться з нами на форумі.

Дивись також