Afficher des documents Word sous forme de pages HTML à l'aide d'une API REST en C#

En tant que développeur C#, vous pouvez facilement convertir des fichiers DOC ou DOCX en pages HTML par programmation dans vos applications .NET sur le cloud. Cela peut être utile pour partager vos documents Word sous forme de pages HTML réactives avec les parties prenantes concernées. Dans cet article, vous apprendrez à afficher des documents Word sous forme de pages HTML à l’aide d’une API REST en C#.

Word vers HTML Viewer API REST et .NET SDK

Pour le rendu des fichiers DOC ou DOCX en HTML, j’utiliserai l’API .NET SDK of GroupDocs.Viewer Cloud. Il vous permet de rendre et d’afficher par programmation toutes sortes de formats de fichiers de documents et d’images populaires tels que Word, Excel, PDF, PowerPoint, Visio, Project, Outlook, JPG, PNG, etc.

Vous pouvez installer GroupDocs.Viewer Cloud dans votre projet Visual Studio à partir du gestionnaire de packages NuGet ou l’installer à l’aide de la commande suivante dans la console du gestionnaire de packages :

Install-Package GroupDocs.Viewer-Cloud

Veuillez obtenir votre ID client et votre secret à partir du tableau de bord avant de commencer à suivre les étapes et les exemples de code disponibles. Une fois que vous avez votre ID client et votre secret, ajoutez le code comme indiqué ci-dessous :

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

var configuration = new Configuration(MyClientId, MyClientSecret);

Afficher des documents Word sous forme de pages HTML à l’aide d’une API REST en C#

Vous pouvez afficher des documents Word sous forme de pages HTML sur le cloud en suivant les étapes simples mentionnées ci-dessous :

Télécharger le document

Tout d’abord, téléchargez le fichier DOCX dans le cloud en utilisant l’exemple de code ci-dessous :

// initialiser l'API
var apiInstance = new FileApi(configuration);

// Ouvrez le fichier dans IOStream à partir de local/disque.
var fileStream = File.Open(@"C:\Files\Sample.docx", FileMode.Open);

// créer une demande de téléchargement de fichier
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);

// téléverser un fichier
var response = apiInstance.UploadFile(request);

Par conséquent, le fichier DOCX téléchargé sera disponible dans la section des fichiers de votre tableau de bord.

Rendre Word en pages HTML à l’aide de C#

Vous pouvez convertir vos documents Word en pages HTML par programme en suivant les étapes ci-dessous :

  • Créer une instance de ViewAPI
  • Créer une instance de FileInfo
  • Indiquez le chemin du fichier d’entrée
  • Créer une instance de ViewOptions
  • Attribuez FileInfo aux ViewOptions
  • Définissez le ViewFormat sur “HTML”
  • Créer une demande de vue en appelant la méthode CreateViewRequest avec ViewOptions
  • Obtenez une réponse en appelant la méthode CreateView() avec CreateViewRequest

L’exemple de code suivant montre comment restituer un document Word en pages HTML à l’aide d’une API REST en C#.

// initialiser l'API
var apiInstance = new ViewApi(configuration);

// chemin du fichier d'entrée
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// définir les options d'affichage
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// créer une demande de vue
var request = new CreateViewRequest(viewOptions);

// créer une vue
var response = apiInstance.CreateView(request);
Affichez les documents Word sous forme de pages HTML à l'aide d'une API REST en C#.

Affichez les documents Word sous forme de pages HTML à l’aide d’une API REST en C#.

Télécharger les pages HTML rendues

L’exemple de code ci-dessus enregistrera les pages HTML rendues sur le cloud. Vous pouvez les télécharger à l’aide de l’exemple de code suivant :

// initialiser l'API
var fileApi = new FileApi(configuration);

// enregistrer toutes les pages HTML rendues
foreach (var page in response.Pages)
{
    // créer une demande de fichier de téléchargement
    var downloadFileRequest = new DownloadFileRequest(page.Path, MyStorage);

    // télécharger un fichier
    var file = fileApi.DownloadFile(downloadFileRequest);
    
    // enregistrer le fichier dans le répertoire de travail
    using (var fileStream = System.IO.File.Create("C:\\Files\\" + page.Path))
    {
        file.Seek(0, SeekOrigin.Begin);
        file.CopyTo(fileStream);
    }
}

Rendre des pages Word en HTML avec des options de rendu à l’aide de C#

Vous pouvez utiliser des options de rendu spécifiques pour restituer des documents Word en pages HTML par programmation en suivant les étapes ci-dessous :

  • Créer une instance de ViewAPI
  • Créer une instance de FileInfo
  • Indiquez le chemin du fichier d’entrée
  • Créer une instance de ViewOptions
  • Attribuez FileInfo aux ViewOptions
  • Définissez le ViewFormat sur “HTML”
  • Créer une instance de RenderOptions
  • Définissez diverses options de rendu telles que PagesToRender, RenderComments, etc.
  • Créer une demande de vue en appelant la méthode CreateViewRequest avec ViewOptions
  • Obtenez une réponse en appelant la méthode CreateView() avec CreateViewRequest

L’exemple de code suivant montre comment rendre un document Word en pages HTML avec des options de rendu à l’aide d’une API REST en C#.

// initialiser l'API
var apiInstance = new ViewApi(configuration);

// chemin du fichier d'entrée
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// définir les options d'affichage
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// définir les options de rendu
viewOptions.RenderOptions = new RenderOptions
{
    // rendre les commentaires
    RenderComments = true,

    // afficher une plage de pages spécifique
    StartPageNumber = 1,
    CountPagesToRender = 2,
};

// créer une demande de vue
var request = new CreateViewRequest(viewOptions);

// créer une vue
var response = apiInstance.CreateView(request);

Rendu Word en HTML avec filigrane à l’aide de C#

Vous pouvez ajouter un texte en filigrane lors du rendu de documents Word en HTML par programmation en suivant les étapes ci-dessous :

  • Créer une instance de ViewAPI
  • Créer une instance de FileInfo
  • Indiquez le chemin du fichier d’entrée
  • Créer une instance de ViewOptions
  • Attribuez FileInfo aux ViewOptions
  • Définissez le ViewFormat sur “HTML”
  • Définir l’option d’affichage du filigrane
  • Définir le texte, la taille, la couleur et la position du filigrane
  • Créer une demande de vue en appelant la méthode CreateViewRequest avec ViewOptions
  • Obtenez une réponse en appelant la méthode CreateView() avec CreateViewRequest

L’exemple de code suivant montre comment ajouter un texte de filigrane aux pages HTML rendues à l’aide d’une API REST en C#.

// initialiser l'API
var apiInstance = new ViewApi(configuration);

// chemin du fichier d'entrée
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// définir les options d'affichage
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// définir le filigrane
viewOptions.Watermark = new Watermark
{
    Text = "This is a sample watermark!",
    Size = 100,
    Color = "Red",
    Position = Watermark.PositionEnum.Diagonal
};
          
// créer une demande de vue
var request = new CreateViewRequest(viewOptions);

// créer une vue
var response = apiInstance.CreateView(request);
Rendu Word vers HTML avec filigrane en utilisant C#.

Rendu Word vers HTML avec filigrane en utilisant C#.

Essayez en ligne

Veuillez essayer l’outil de rendu Word en ligne gratuit suivant, qui est développé à l’aide de l’API ci-dessus. https://products.groupdocs.app/viewer/docx

Conclusion

Dans cet article, vous avez appris à afficher des documents Word sous forme de pages HTML sur le cloud. Vous avez également appris à rendre Word en HTML avec des options de rendu en C#. De plus, vous avez appris à ajouter un filigrane de texte aux pages HTML rendues par programmation à l’aide de C#. De plus, vous avez appris à télécharger par programmation un fichier DOCX dans le cloud, puis à télécharger les fichiers HTML rendus à partir du cloud. Vous pouvez en savoir plus sur l’API GroupDocs.Viewer Cloud à l’aide de la documentation. Nous fournissons également une section API Reference qui vous permet de visualiser et d’interagir avec nos API directement via le navigateur. En cas d’ambiguïté, n’hésitez pas à nous contacter sur le forum.

Voir également