Wyświetl dokumenty programu Word jako strony HTML przy użyciu interfejsu API REST w języku C#

Jako programista języka C# możesz łatwo programowo renderować pliki DOC lub DOCX na strony HTML w swoich aplikacjach .NET w chmurze. Może to być przydatne w udostępnianiu dokumentów programu Word jako responsywnych stron HTML odpowiednim interesariuszom. W tym artykule dowiesz się, jak wyświetlać dokumenty programu Word jako strony HTML przy użyciu interfejsu API REST w języku C#.

Word to HTML Viewer REST API i .NET SDK

Do renderowania plików DOC lub DOCX do formatu HTML będę używał .NET SDK of GroupDocs.Viewer Cloud API. Umożliwia programowe renderowanie i przeglądanie wszelkiego rodzaju popularnych formatów dokumentów i plików graficznych, takich jak Word, Excel, PDF, PowerPoint, Visio, Project, Outlook, JPG, PNG itp.

Możesz zainstalować GroupDocs.Viewer Cloud w swoim projekcie Visual Studio z Menedżera pakietów NuGet lub zainstalować go za pomocą następującego polecenia w konsoli Menedżera pakietów:

Install-Package GroupDocs.Viewer-Cloud

Uzyskaj swój identyfikator klienta i klucz tajny z panelu nawigacyjnego, zanim zaczniesz postępować zgodnie z instrukcjami i dostępnymi przykładami kodu. Po uzyskaniu identyfikatora klienta i klucza tajnego dodaj kod, jak pokazano poniżej:

string MyClientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
string MyClientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
string MyStorage = "";

var configuration = new Configuration(MyClientId, MyClientSecret);

Wyświetl dokumenty programu Word jako strony HTML przy użyciu interfejsu API REST w języku C#

Możesz wyświetlać dokumenty programu Word jako strony HTML w chmurze, wykonując proste czynności wymienione poniżej:

Prześlij dokument

Najpierw prześlij plik DOCX do chmury, korzystając z przykładowego kodu podanego poniżej:

// zainicjować API
var apiInstance = new FileApi(configuration);

// Otwórz plik w IOStream z pliku local/disc.
var fileStream = File.Open(@"C:\Files\Sample.docx", FileMode.Open);

// utwórz żądanie przesłania pliku
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);

// Przesyłanie pliku
var response = apiInstance.UploadFile(request);

W rezultacie przesłany plik DOCX będzie dostępny w sekcji plików Twojego pulpitu nawigacyjnego.

Renderuj strony Word do HTML za pomocą C#

Możesz programowo renderować dokumenty programu Word na strony HTML, wykonując następujące czynności:

  • Utwórz instancję ViewAPI
  • Utwórz instancję FileInfo
  • Podaj ścieżkę pliku wejściowego
  • Utwórz instancję ViewOptions
  • Przypisz FileInfo do ViewOptions
  • Ustaw ViewFormat jako „HTML”
  • Utwórz żądanie wyświetlenia, wywołując metodę CreateViewRequest z ViewOptions
  • Uzyskaj odpowiedź, wywołując metodę CreateView() z funkcją CreateViewRequest

Poniższy przykładowy kod pokazuje, jak renderować dokument programu Word na strony HTML przy użyciu interfejsu API REST w języku C#.

// zainicjować API
var apiInstance = new ViewApi(configuration);

// ścieżka pliku wejściowego
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// zdefiniuj opcje widoku
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// utwórz żądanie wyświetlenia
var request = new CreateViewRequest(viewOptions);

// utwórz widok
var response = apiInstance.CreateView(request);
Przeglądaj dokumenty programu Word jako strony HTML przy użyciu interfejsu API REST w języku C#.

Przeglądaj dokumenty programu Word jako strony HTML przy użyciu interfejsu API REST w języku C#.

Pobierz wyrenderowane strony HTML

Powyższy przykładowy kod zapisze wyrenderowane strony HTML w chmurze. Możesz je pobrać, korzystając z następującego przykładowego kodu:

// zainicjować API
var fileApi = new FileApi(configuration);

// zapisz wszystkie renderowane strony HTML
foreach (var page in response.Pages)
{
    // utwórz żądanie pobrania pliku
    var downloadFileRequest = new DownloadFileRequest(page.Path, MyStorage);

    // pobieranie pliku
    var file = fileApi.DownloadFile(downloadFileRequest);
    
    // zapisz plik w katalogu roboczym
    using (var fileStream = System.IO.File.Create("C:\\Files\\" + page.Path))
    {
        file.Seek(0, SeekOrigin.Begin);
        file.CopyTo(fileStream);
    }
}

Renderuj strony Word do HTML z opcjami renderowania przy użyciu C#

Możesz użyć określonych opcji renderowania, aby programowo renderować dokumenty programu Word na strony HTML, wykonując czynności podane poniżej:

  • Utwórz instancję ViewAPI
  • Utwórz instancję FileInfo
  • Podaj ścieżkę pliku wejściowego
  • Utwórz instancję ViewOptions
  • Przypisz FileInfo do ViewOptions
  • Ustaw ViewFormat jako „HTML”
  • Utwórz instancję RenderOptions
  • Ustaw różne opcje renderowania, takie jak PagesToRender, RenderComments itp.
  • Utwórz żądanie wyświetlenia, wywołując metodę CreateViewRequest z ViewOptions
  • Uzyskaj odpowiedź, wywołując metodę CreateView() z CreateViewRequest

Poniższy przykładowy kod pokazuje, jak renderować dokument programu Word na strony HTML z opcjami renderowania przy użyciu interfejsu API REST w języku C#.

// zainicjować API
var apiInstance = new ViewApi(configuration);

// ścieżka pliku wejściowego
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// zdefiniuj opcje widoku
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// zdefiniuj opcje renderowania
viewOptions.RenderOptions = new RenderOptions
{
    // renderować komentarze
    RenderComments = true,

    // renderować określony zakres stron
    StartPageNumber = 1,
    CountPagesToRender = 2,
};

// utwórz żądanie wyświetlenia
var request = new CreateViewRequest(viewOptions);

// utwórz widok
var response = apiInstance.CreateView(request);

Renderowanie Worda do HTML ze znakiem wodnym przy użyciu C#

Możesz dodać tekst znaku wodnego podczas programowego renderowania dokumentów programu Word do formatu HTML, wykonując czynności podane poniżej:

  • Utwórz instancję ViewAPI
  • Utwórz instancję FileInfo
  • Podaj ścieżkę pliku wejściowego
  • Utwórz instancję ViewOptions
  • Przypisz FileInfo do ViewOptions
  • Ustaw ViewFormat jako „HTML”
  • Zdefiniuj opcję widoku znaku wodnego
  • Ustaw tekst, rozmiar, kolor i położenie znaku wodnego
  • Utwórz żądanie wyświetlenia, wywołując metodę CreateViewRequest z ViewOptions
  • Uzyskaj odpowiedź, wywołując metodę CreateView() z CreateViewRequest

Poniższy przykładowy kod pokazuje, jak dodać tekst znaku wodnego do renderowanych stron HTML przy użyciu interfejsu API REST w języku C#.

// zainicjować API
var apiInstance = new ViewApi(configuration);

// ścieżka pliku wejściowego
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// zdefiniuj opcje widoku
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// zdefiniuj znak wodny
viewOptions.Watermark = new Watermark
{
    Text = "This is a sample watermark!",
    Size = 100,
    Color = "Red",
    Position = Watermark.PositionEnum.Diagonal
};
          
// utwórz żądanie wyświetlenia
var request = new CreateViewRequest(viewOptions);

// utwórz widok
var response = apiInstance.CreateView(request);
Renderowanie Worda do HTML ze znakiem wodnym przy użyciu C#.

Renderowanie Worda do HTML ze znakiem wodnym przy użyciu C#.

Wypróbuj online

Wypróbuj następujące bezpłatne narzędzie do renderowania programu Word online, które zostało opracowane przy użyciu powyższego interfejsu API. https://products.groupdocs.app/viewer/docx

Wniosek

W tym artykule nauczyłeś się, jak wyświetlać dokumenty programu Word jako strony HTML w chmurze. Nauczyłeś się również, jak renderować Worda do HTML z opcjami renderowania w C#. Ponadto nauczyłeś się programowo dodawać tekstowy znak wodny do renderowanych stron HTML przy użyciu języka C#. Ponadto nauczyłeś się, jak programowo przesłać plik DOCX do chmury, a następnie pobrać wyrenderowane pliki HTML z chmury. Możesz dowiedzieć się więcej o GroupDocs.Viewer Cloud API, korzystając z dokumentacji. Udostępniamy również sekcję Informacje o interfejsach API, która umożliwia wizualizację naszych interfejsów API i interakcję z nimi bezpośrednio w przeglądarce. W przypadku jakichkolwiek niejasności prosimy o kontakt na forum.

Zobacz też