Ver documentos de Word como páginas HTML usando una API REST en C#

Como desarrollador de C#, puede representar fácilmente archivos DOC o DOCX en páginas HTML mediante programación en sus aplicaciones .NET en la nube. Puede ser útil para compartir sus documentos de Word como páginas HTML receptivas con las partes interesadas relevantes. En este artículo, aprenderá a ver documentos de Word como páginas HTML mediante una API REST en C#.

Word to HTML Viewer REST API y .NET SDK

Para renderizar archivos DOC o DOCX a HTML, utilizaré la API .NET SDK de GroupDocs.Viewer Cloud. Le permite representar y ver mediante programación todo tipo de formatos populares de archivos de imágenes y documentos, como Word, Excel, PDF, PowerPoint, Visio, Project, Outlook, JPG, PNG, etc.

Puede instalar GroupDocs.Viewer Cloud en su proyecto de Visual Studio desde el Administrador de paquetes NuGet o instalarlo con el siguiente comando en la consola del Administrador de paquetes:

Install-Package GroupDocs.Viewer-Cloud

Obtenga su ID de cliente y secreto del panel de control antes de comenzar a seguir los pasos y los ejemplos de código disponibles. Una vez que tenga su ID de cliente y secreto, agregue el código como se muestra a continuación:

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

var configuration = new Configuration(MyClientId, MyClientSecret);

Ver documentos de Word como páginas HTML usando una API REST en C#

Puede ver documentos de Word como páginas HTML en la nube siguiendo los sencillos pasos que se mencionan a continuación:

Sube el documento

En primer lugar, cargue el archivo DOCX en la nube usando el ejemplo de código que se muestra a continuación:

// inicializar API
var apiInstance = new FileApi(configuration);

// Abra el archivo en IOStream desde local/disco.
var fileStream = File.Open(@"C:\Files\Sample.docx", FileMode.Open);

// crear solicitud de carga de archivo
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);

// subir archivo
var response = apiInstance.UploadFile(request);

Como resultado, el archivo DOCX cargado estará disponible en la sección de archivos de su tablero.

Renderizar Word a páginas HTML usando C#

Puede convertir sus documentos de Word en páginas HTML mediante programación siguiendo los pasos que se detallan a continuación:

  • Crear una instancia de ViewAPI
  • Crear una instancia de FileInfo
  • Proporcione la ruta del archivo de entrada
  • Crear una instancia de ViewOptions
  • Asigne FileInfo a ViewOptions
  • Establezca ViewFormat como “HTML”
  • Cree una solicitud de vista llamando al método CreateViewRequest con ViewOptions
  • Obtenga una respuesta llamando al método CreateView() con CreateViewRequest

El siguiente ejemplo de código muestra cómo representar un documento de Word en páginas HTML mediante una API REST en C#.

// inicializar API
var apiInstance = new ViewApi(configuration);

// ruta del archivo de entrada
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// definir las opciones de vista
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// crear solicitud de vista
var request = new CreateViewRequest(viewOptions);

// crear vista
var response = apiInstance.CreateView(request);
Vea documentos de Word como páginas HTML usando una API REST en C#.

Vea documentos de Word como páginas HTML usando una API REST en C#.

Descargar las páginas HTML procesadas

El ejemplo de código anterior guardará las páginas HTML renderizadas en la nube. Puede descargarlos utilizando el siguiente ejemplo de código:

// inicializar API
var fileApi = new FileApi(configuration);

// guardar todas las páginas HTML renderizadas
foreach (var page in response.Pages)
{
    // crear solicitud de archivo de descarga
    var downloadFileRequest = new DownloadFileRequest(page.Path, MyStorage);

    // descargar archivo
    var file = fileApi.DownloadFile(downloadFileRequest);
    
    // guardar archivo en el directorio de trabajo
    using (var fileStream = System.IO.File.Create("C:\\Files\\" + page.Path))
    {
        file.Seek(0, SeekOrigin.Begin);
        file.CopyTo(fileStream);
    }
}

Renderizar Word a páginas HTML con opciones de renderizado usando C#

Puede usar opciones de representación específicas para representar documentos de Word en páginas HTML mediante programación siguiendo los pasos que se indican a continuación:

  • Cree una instancia de ViewAPI
  • Crear una instancia de FileInfo
  • Proporcione la ruta del archivo de entrada
  • Crear una instancia de ViewOptions
  • Asigne FileInfo a ViewOptions
  • Establezca ViewFormat como “HTML”
  • Crear una instancia de RenderOptions
  • Establezca varias opciones de representación, como PagesToRender, RenderComments, etc.
  • Cree una solicitud de vista llamando al método CreateViewRequest con ViewOptions
  • Obtenga una respuesta llamando al método CreateView() con CreateViewRequest

El siguiente ejemplo de código muestra cómo representar un documento de Word en páginas HTML con opciones de representación mediante una API REST en C#.

// inicializar API
var apiInstance = new ViewApi(configuration);

// ruta del archivo de entrada
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// definir las opciones de vista
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// definir opciones de renderizado
viewOptions.RenderOptions = new RenderOptions
{
    // hacer comentarios
    RenderComments = true,

    // renderizar rango específico de páginas
    StartPageNumber = 1,
    CountPagesToRender = 2,
};

// crear solicitud de vista
var request = new CreateViewRequest(viewOptions);

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

Representación de Word a HTML con marca de agua usando C#

Puede agregar un texto de marca de agua mientras procesa documentos de Word a HTML mediante programación siguiendo los pasos que se detallan a continuación:

  • Cree una instancia de ViewAPI
  • Crear una instancia de FileInfo
  • Proporcione la ruta del archivo de entrada
  • Crear una instancia de ViewOptions
  • Asigne FileInfo a ViewOptions
  • Establezca ViewFormat como “HTML”
  • Definir la opción de vista Marca de agua
  • Establecer el texto, el tamaño, el color y la posición de la marca de agua
  • Cree una solicitud de vista llamando al método CreateViewRequest con ViewOptions
  • Obtenga una respuesta llamando al método CreateView() con CreateViewRequest

El siguiente ejemplo de código muestra cómo agregar un texto de marca de agua a las páginas HTML representadas mediante una API REST en C#.

// inicializar API
var apiInstance = new ViewApi(configuration);

// ruta del archivo de entrada
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";

// definir las opciones de vista
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML;   // output view format

// definir marca de agua
viewOptions.Watermark = new Watermark
{
    Text = "This is a sample watermark!",
    Size = 100,
    Color = "Red",
    Position = Watermark.PositionEnum.Diagonal
};
          
// crear solicitud de vista
var request = new CreateViewRequest(viewOptions);

// crear vista
var response = apiInstance.CreateView(request);
Representación de Word a HTML con marca de agua usando C#.

Representación de Word a HTML con marca de agua usando C#.

Prueba en línea

Pruebe la siguiente herramienta gratuita de representación de Word en línea, que se desarrolla utilizando la API anterior. https://products.groupdocs.app/viewer/docx

Conclusión

En este artículo, ha aprendido a ver documentos de Word como páginas HTML en la nube. También aprendió cómo representar Word a HTML con opciones de representación en C#. Además, aprendió cómo agregar una marca de agua de texto a las páginas HTML procesadas mediante programación usando C#. Además, ha aprendido cómo cargar un archivo DOCX en la nube mediante programación y luego descargar los archivos HTML renderizados desde la nube. Puede obtener más información sobre GroupDocs.Viewer Cloud API utilizando la documentación. También proporcionamos una sección Referencia de API que le permite visualizar e interactuar con nuestras API directamente a través del navegador. En caso de cualquier ambigüedad, no dude en contactarnos en el foro.

Ver también