Visualizza i documenti di Word come pagine HTML utilizzando un'API REST in C#

In qualità di sviluppatore C#, puoi eseguire facilmente il rendering di file DOC o DOCX in pagine HTML a livello di codice nelle tue applicazioni .NET nel cloud. Può essere utile per condividere i tuoi documenti Word come pagine HTML reattive con le parti interessate. In questo articolo imparerai come visualizzare i documenti di Word come pagine HTML utilizzando un’API REST in C#.

API REST del visualizzatore da Word a HTML e .NET SDK

Per il rendering dei file DOC o DOCX in HTML, utilizzerò l’API .NET SDK of GroupDocs.Viewer Cloud. Ti consente di eseguire il rendering e visualizzare in modo programmatico tutti i tipi di documenti e formati di file immagine più diffusi come Word, Excel, PDF, PowerPoint, Visio, Project, Outlook, JPG, PNG, ecc.

È possibile installare GroupDocs.Viewer Cloud nel progetto di Visual Studio da NuGet Package Manager o installarlo utilizzando il comando seguente nella console di Package Manager:

Install-Package GroupDocs.Viewer-Cloud

Ottieni il tuo ID cliente e segreto dalla dashboard prima di iniziare a seguire i passaggi e gli esempi di codice disponibili. Una volta che hai il tuo ID cliente e segreto, aggiungi il codice come mostrato di seguito:

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

var configuration = new Configuration(MyClientId, MyClientSecret);

Visualizza i documenti di Word come pagine HTML utilizzando un’API REST in C#

Puoi visualizzare i documenti di Word come pagine HTML sul cloud seguendo i semplici passaggi indicati di seguito:

Carica il documento

Innanzitutto, carica il file DOCX nel cloud utilizzando l’esempio di codice riportato di seguito:

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

// Apri il file in IOStream da locale/disco.
var fileStream = File.Open(@"C:\Files\Sample.docx", FileMode.Open);

// creare richiesta di caricamento file
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);

// caricare un file
var response = apiInstance.UploadFile(request);

Di conseguenza, il file DOCX caricato sarà disponibile nella sezione file della tua dashboard.

Renderizza Word in pagine HTML usando C#

Puoi eseguire il rendering dei tuoi documenti Word in pagine HTML a livello di codice seguendo i passaggi indicati di seguito:

  • Crea un’istanza di ViewAPI
  • Crea un’istanza di FileInfo
  • Fornire il percorso del file di input
  • Crea un’istanza di ViewOptions
  • Assegna FileInfo a ViewOptions
  • Imposta ViewFormat come “HTML”
  • Crea una richiesta di visualizzazione chiamando il metodo CreateViewRequest con ViewOptions
  • Ottieni una risposta chiamando il metodo CreateView() con CreateViewRequest

L’esempio di codice seguente mostra come eseguire il rendering di un documento di Word in pagine HTML usando un’API REST in C#.

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

// percorso del file di input
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// definire le opzioni di visualizzazione
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// creare richiesta di visualizzazione
var request = new CreateViewRequest(viewOptions);

// creare vista
var response = apiInstance.CreateView(request);
Visualizza i documenti di Word come pagine HTML utilizzando un'API REST in C#.

Visualizza i documenti di Word come pagine HTML utilizzando un’API REST in C#.

Scarica le pagine HTML renderizzate

L’esempio di codice precedente salverà le pagine HTML renderizzate nel cloud. Puoi scaricarli utilizzando il seguente esempio di codice:

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

// salvare tutte le pagine HTML renderizzate
foreach (var page in response.Pages)
{
    // creare richiesta di file di download
    var downloadFileRequest = new DownloadFileRequest(page.Path, MyStorage);

    // download file
    var file = fileApi.DownloadFile(downloadFileRequest);
    
    // salvare il file nella directory di lavoro
    using (var fileStream = System.IO.File.Create("C:\\Files\\" + page.Path))
    {
        file.Seek(0, SeekOrigin.Begin);
        file.CopyTo(fileStream);
    }
}

Rendering di pagine da Word a HTML con opzioni di rendering utilizzando C#

È possibile utilizzare opzioni di rendering specifiche per eseguire il rendering di documenti Word in pagine HTML a livello di codice seguendo i passaggi indicati di seguito:

  • Crea un’istanza di ViewAPI
  • Crea un’istanza di FileInfo
  • Fornire il percorso del file di input
  • Crea un’istanza di ViewOptions
  • Assegna FileInfo a ViewOptions
  • Imposta ViewFormat come “HTML”
  • Crea un’istanza di RenderOptions
  • Imposta varie opzioni di rendering come PagesToRender, RenderComments, ecc.
  • Crea una richiesta di visualizzazione chiamando il metodo CreateViewRequest con ViewOptions
  • Ottieni una risposta chiamando il metodo CreateView() con CreateViewRequest

L’esempio di codice seguente mostra come eseguire il rendering di un documento di Word in pagine HTML con opzioni di rendering usando un’API REST in C#.

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

// percorso del file di input
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// definire le opzioni di visualizzazione
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// definire le opzioni di rendering
viewOptions.RenderOptions = new RenderOptions
{
    // rendere i commenti
    RenderComments = true,

    // eseguire il rendering di un intervallo specifico di pagine
    StartPageNumber = 1,
    CountPagesToRender = 2,
};

// creare richiesta di visualizzazione
var request = new CreateViewRequest(viewOptions);

// creare vista
var response = apiInstance.CreateView(request);

Rendering da Word a HTML con filigrana utilizzando C#

È possibile aggiungere un testo filigrana durante il rendering di documenti Word in HTML a livello di codice seguendo i passaggi indicati di seguito:

  • Crea un’istanza di ViewAPI
  • Crea un’istanza di FileInfo
  • Fornire il percorso del file di input
  • Crea un’istanza di ViewOptions
  • Assegna FileInfo a ViewOptions
  • Imposta ViewFormat come “HTML”
  • Definisci l’opzione di visualizzazione Filigrana
  • Imposta il testo, le dimensioni, il colore e la posizione della filigrana
  • Crea una richiesta di visualizzazione chiamando il metodo CreateViewRequest con ViewOptions
  • Ottieni una risposta chiamando il metodo CreateView() con CreateViewRequest

L’esempio di codice seguente mostra come aggiungere un testo filigrana alle pagine HTML sottoposte a rendering usando un’API REST in C#.

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

// percorso del file di input
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// definire le opzioni di visualizzazione
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// definire filigrana
viewOptions.Watermark = new Watermark
{
    Text = "This is a sample watermark!",
    Size = 100,
    Color = "Red",
    Position = Watermark.PositionEnum.Diagonal
};
          
// creare richiesta di visualizzazione
var request = new CreateViewRequest(viewOptions);

// creare vista
var response = apiInstance.CreateView(request);
Rendering da Word a HTML con filigrana utilizzando C#.

Rendering da Word a HTML con filigrana utilizzando C#.

Prova in linea

Prova il seguente strumento di rendering di Word online gratuito, sviluppato utilizzando l’API di cui sopra. https://products.groupdocs.app/viewer/docx

Conclusione

In questo articolo, hai imparato a visualizzare i documenti di Word come pagine HTML nel cloud. Hai anche imparato come eseguire il rendering di Word in HTML con le opzioni di rendering in C#. Inoltre, hai imparato come aggiungere una filigrana di testo alle pagine HTML renderizzate in modo programmatico utilizzando C#. Inoltre, hai imparato come caricare in modo programmatico un file DOCX nel cloud e quindi scaricare i file HTML renderizzati dal cloud. Puoi saperne di più su GroupDocs.Viewer Cloud API utilizzando la documentazione. Forniamo anche una sezione Riferimento API che ti consente di visualizzare e interagire con le nostre API direttamente attraverso il browser. In caso di qualsiasi ambiguità, non esitate a contattarci sul forum.

Guarda anche