Installation

The package is available at nuget.org and it can be installed via package manager console by executing following command:

PM> NuGet\Install-Package GroupDocs.viewer-Cloud

.NET Cloud REST API for Document Rendering

GroupDocs.Viewer Cloud SDK for .NET offers a powerful document rendering solution that supports a wide range of formats such as Word, Excel, PDFs, CAD, emails, and more. Developers can easily convert and render documents into HTML, PDF, and image formats, preserving the original document’s structure and layout. With advanced features like streaming output, custom view options, multi-page rendering, and support for various file types, GroupDocs.Viewer Cloud API provides seamless integration for document viewing needs in any web or cloud application. Sign up for free to start leveraging the flexibility and capabilities of this robust cloud-based API.

Basic Usage

Simple Viewer Setup

Guide to quickly set up the GroupDocs.Viewer with minimal configuration.

Load Document from Cloud

Instructions on loading documents directly from cloud storage for viewing.

Custom View Options

Steps for customizing the viewer settings such as zoom, layout, and navigation.

Supported File Formats

Detailed list of supported file formats that can be viewed without conversion.

HTML Viewer

Convert Documents to HTML

Process of converting documents to HTML format for seamless browser-based viewing.

Stream HTML Output

Guide on streaming HTML content for document rendering in real-time.

Preserve Document Structure in HTML

Instructions to maintain the original layout and structure when converting to HTML.

Custom HTML Viewing Options

Features for customizing the appearance of HTML-viewed documents, including styles and fonts.

Image Viewer

Convert Documents to Images

Steps to convert documents into image formats like PNG and JPEG for viewing.

Stream Image Output

Guide for streaming image formats from the document viewer.

Customize Image Resolution

Options for setting specific image resolution when viewing documents as images.

Multi-Page Document Image Rendering

Instructions for rendering multi-page documents as separate images.

PDF Viewer

Convert Documents to PDF

Convert any supported document format into a PDF for viewing.

Stream PDF Output

Guide to stream PDF content for optimized viewing in browsers or applications.

Embed PDF Viewer

Instructions for embedding a customizable PDF viewer in your application.

PDF viewer Support

Features for viewing and interacting with viewers in PDF documents.

Render Document

Render Document to HTML, Image, or PDF

Options to render documents into HTML, image, or PDF formats for viewing.

Stream Rendered Output

Stream the rendered document output for real-time access in your application.

Multi-Page Document Rendering

Support for rendering multi-page documents into multiple HTML, image, or PDF files.

Rendering Options by Document Type

Specialized Rendering for File Types

Custom rendering options tailored for various document types like Word, Excel, PDF, and more.

Preserve Document Features

Ensure original document features like layout, text, and formatting are retained during rendering.

Rendering Archive Files

Render ZIP, RAR, and TAR Files

Convert archive file formats like ZIP, RAR, and TAR into viewable content.

Extract and Render Specific Files

Extract specific files from archives and render them without downloading the entire archive.

Rendering CAD Drawings

Render CAD Formats (DWG, DXF, etc.)

Convert and display CAD files such as DWG and DXF for detailed viewing.

Customize CAD Rendering Options

Set specific parameters for CAD rendering, such as zoom level, layer visibility, and layout.

Rendering E-Mail Messages

Render MSG, EML, and MHTML Formats

View email messages in formats like MSG, EML, and MHTML directly within the viewer.

View Attachments

Automatically render and display email attachments for easy access.

Rendering Lotus Notes Database Messages

Render NSF Database Messages

Convert and view Lotus Notes (NSF) database messages in supported formats.

Access Embedded Elements

Render and view embedded images, files, and links within Lotus Notes database messages.

Rendering MS Project Documents

Render MS Project Files (MPP)

Convert MS Project (MPP) files to HTML, images, or PDF for easy viewing.

View Project Data

Render task, resource, and Gantt chart views from MS Project files.

Rendering Outlook Data Files

Render PST and OST Files

Convert Outlook PST and OST data files to HTML, images, or PDF formats for viewing.

View Emails, Calendars, and Contacts

Render individual email messages, calendar events, and contact details from Outlook data files.

Rendering PDF Documents

Convert PDF to HTML, Image, or Other Formats

Render PDF documents into HTML, image, or other supported formats for web-based or application viewing.

PDF viewers and Bookmarks

Support for rendering PDF documents with viewers, bookmarks, and other embedded elements.

Rendering Spreadsheets

Render Excel Files (XLS, XLSX)

Convert spreadsheet files like XLS and XLSX into HTML, images, or PDF formats.

View Charts and Formulas

Render spreadsheet charts, formulas, and complex cell formats for accurate viewing.

Rendering Text Files

Render Plain Text and CSV Files

Convert plain text and CSV files to HTML, images, or PDF for simplified viewing.

Preserve Text Formatting

Maintain original text layout and formatting during rendering.

Rendering Visio Documents

Render Visio Files (VSD, VSDX)

Convert and display Visio diagram files in HTML, image, or PDF formats.

View Diagrams and Flowcharts

Render diagrams, flowcharts, and shapes from Visio files for clear presentation.

Rendering Word Processing Documents

Render Word Files (DOC, DOCX, ODT)

Convert Word processing files such as DOC, DOCX, and ODT to HTML, image, or PDF formats.

Preserve Document Structure

Ensure accurate rendering of document structure, including headers, footers, and formatting.

Working With Document Pages

Extract Pages from Documents

Extract specific pages from documents for individual rendering.

Customize Page Viewing

Control pagination and page display settings for document viewing.

Rendering Document Pages

Render Pages to HTML, Image, or PDF

Convert individual document pages into HTML, image, or PDF formats for viewing.

Stream Page Output

Stream individual document pages for faster load times and real-time viewing.

Minification of HTML and SVG

Minify HTML Content

Reduce the size of rendered HTML content for faster page loads.

Optimize SVG Output

Minify and optimize SVG output to improve performance without losing quality.

Rendering Document to Responsive HTML

Convert to Responsive HTML

Render documents as responsive HTML that adapts to various screen sizes and devices.

Mobile-Friendly Viewing

Ensure documents are optimized for mobile and tablet devices using responsive HTML rendering.

Rendering Email Messages

Convert Email Messages to HTML, Image, or PDF

Render email messages (MSG, EML) into HTML, image, or PDF formats for viewing.

Preserve Email Structure

Ensure email headers, body, and attachments are preserved during rendering.

Working with Attachments

Extract and Render Attachments

Extract and render attachments from documents or email messages for easy viewing.

View Attachment Types

Support for viewing various attachment types like images, documents, and archives.

Attachment Information

Display Attachment Metadata

Show attachment metadata such as file name, size, and format.

Access Attachment Details

View details and properties of document or email attachments.

Attachment Pages

Render Attachment Pages

Render individual pages of attachments for detailed viewing.

Stream Attachment Pages

Stream attachment pages for real-time rendering and improved load times.

Attachment Page Resources

Extract Resources from Attachment Pages

Extract resources such as images, links, and embedded elements from attachment pages.

Access Page-Specific Elements

Retrieve specific page-level elements within attachments for customized rendering.

Supported CAD Formats

Supported Diagram Formats

Supported eBook Formats

Supported Email Formats

Supported Image Formats

Supported Web Formats

Supported Note Formats

Supported Page Layout Formats

Supported Presentation Formats

Supported Project Management Formats

Supported Spreadsheet Formats

Supported Word Processing Formats

Quick Start Guide

1. Create an Account

Sign up for a free account at GroupDocs Cloud.

2. Create an API Client App

In the GroupDocs Cloud Dashboard, create a new application or use an existing one to obtain your Client ID and Client Secret.

3. Install the SDK

Add the GroupDocs.Viewer Cloud SDK for .NET by running this command in the Package Manager Console in Visual Studio:

Install-Package GroupDocs.Viewer-Cloud

To update the SDK, use:

Update-Package GroupDocs.Viewer-Cloud

4. Make an API Request

Use your Client ID and Client Secret to authenticate and make API requests. Below is an example using the Document Viewer API:

// For complete examples and data files, please go to https://github.com/groupdocs-viewer-cloud/groupdocs-viewer-cloud-dotnet-samples
// Get Client Id and Client Secret from https://dashboard.groupdocs.cloud
string MyClientSecret = "";
string MyClientId = "";

var configuration = new Configuration(MyClientId, MyClientSecret);
var apiInstance = new ViewApi(configuration);

var viewOptions = new ViewOptions {
    FileInfo = new FileInfo {
            FilePath = "SampleFiles/with_tracked_changes.docx"
        },
        ViewFormat = ViewOptions.ViewFormatEnum.HTML,
        RenderOptions = new HtmlOptions {
            WordProcessingOptions = new WordProcessingOptions {
                RenderTrackedChanges = true
            }
        }
};

var response = apiInstance.CreateView(new CreateViewRequest(viewOptions));

Rendering a Document as PDF

This example demonstrates how to render a document to PDF format using GroupDocs.Viewer Cloud API.

// For complete examples and data files, please go to https://github.com/groupdocs-viewer-cloud/groupdocs-viewer-cloud-dotnet-samples
using System;
using GroupDocs.Viewer.Cloud.Sdk.Api;
using GroupDocs.Viewer.Cloud.Sdk.Client;
using GroupDocs.Viewer.Cloud.Sdk.Model;
using GroupDocs.Viewer.Cloud.Sdk.Model.Requests;

namespace Examples
{
    class Program
    {
        static void Main(string[] args)
        {
            var configuration = new Configuration
            {
                AppSid = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                AppKey = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
            };
            
            var viewerApi = new ViewerApi(configuration);
            var fileInfo = new FileInfo
            {
                FilePath = "SampleFiles/sample.docx"
            };
            
            var viewOptions = new ViewOptions
            {
                FileInfo = fileInfo,
                ViewFormat = ViewOptions.ViewFormatEnum.PDF
            };

            var request = new CreateViewRequest(viewOptions);
            var response = viewerApi.CreateView(request);
            Console.WriteLine("Document rendered: " + response.Pages.Count + " pages.");
        }
    }
}

Render Spreadsheet as HTML

This code sample converts an Excel spreadsheet into HTML using GroupDocs.Viewer Cloud API.

// For complete examples and data files, please go to https://github.com/groupdocs-viewer-cloud/groupdocs-viewer-cloud-dotnet-samples
using System;
using GroupDocs.Viewer.Cloud.Sdk.Api;
using GroupDocs.Viewer.Cloud.Sdk.Client;
using GroupDocs.Viewer.Cloud.Sdk.Model;
using GroupDocs.Viewer.Cloud.Sdk.Model.Requests;

namespace Examples
{
    class Program
    {
        static void Main(string[] args)
        {
            var configuration = new Configuration
            {
                AppSid = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                AppKey = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
            };

            var viewerApi = new ViewerApi(configuration);
            var fileInfo = new FileInfo
            {
                FilePath = "SampleFiles/sample.xlsx"
            };

            var viewOptions = new ViewOptions
            {
                FileInfo = fileInfo,
                ViewFormat = ViewOptions.ViewFormatEnum.HTML
            };

            var request = new CreateViewRequest(viewOptions);
            var response = viewerApi.CreateView(request);
            Console.WriteLine("Spreadsheet rendered to HTML: " + response.Pages.Count + " pages.");
        }
    }
}

Get Supported File Formats

This code sample retrieves all supported file formats for rendering via the GroupDocs.Viewer Cloud API.

// For complete examples and data files, please go to https://github.com/groupdocs-viewer-cloud/groupdocs-viewer-cloud-dotnet-samples
using System;
using GroupDocs.Viewer.Cloud.Sdk.Api;
using GroupDocs.Viewer.Cloud.Sdk.Client;
using GroupDocs.Viewer.Cloud.Sdk.Model.Requests;

namespace Examples
{
    class Program
    {
        static void Main(string[] args)
        {
            var configuration = new Configuration
            {
                AppSid = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                AppKey = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
            };

            var viewerApi = new ViewerApi(configuration);
            var request = new GetSupportedFileFormatsRequest();
            var response = viewerApi.GetSupportedFileFormats(request);

            foreach (var format in response.Formats)
            {
                Console.WriteLine(format.FileFormat + ": " + format.Extension);
            }
        }
    }
}

Tags

Document Rendering API | .NET Cloud API | GroupDocs.Viewer Cloud | REST API | HTML Rendering | PDF Conversion | Image Rendering | Document Viewing | Multi-Page Rendering | Document Streaming | CAD Rendering | E-Mail Message Rendering | Visio Rendering | MS Project Rendering | Outlook Data Rendering | Spreadsheet Rendering | Word Processing Rendering | Custom View Options