Skip to end of metadata
Go to start of metadata

This page contains release notes for GroupDocs.Viewer for .NET 19.3.

Major Features

There are 10 features, improvements, and fixes in this regular monthly release. The most notable are:

  • Added Cs and Vb file formats support
  • Feature for detecting printing restriction in PDF documents, and the ability to print such documents
  • Ability to specify owner password, user password, and permissions when rendering into PDF

Full List of Issues Covering all Changes in this Release

KeySummaryCategory
VIEWERNET-1895Add Visual Basic (.vb) file format supportFeature
VIEWERNET-1894Add C# (.cs) file format supportFeature
VIEWERNET-1860Obtaining list of folders contained in the zip archiveFeature
VIEWERNET-1913Detect restriction for the printingFeature
VIEWERNET-1905Print PDF documents which have restriction for printingFeature
VIEWERNET-1909Specify owner password, user password and permissions when rendering into PDFFeature
VIEWERNET-1858Show contact image when rendering vCard documentsImprovement
VIEWERNET-1856Improve output for rendering zip archivesImprovement
VIEWERNET-1911Out of memory exceptionBug
VIEWERNET-1910Document corrupted exceptionBug

This section lists public API changes that were introduced in GroupDocs.Viewer for .NET 19.3. It includes not only new and obsoleted public methods, but also a description of any changes in the behavior behind the scenes in GroupDocs.Viewer which may affect existing code. Any behavior introduced that could be seen as a regression and modifies existing behavior is especially important and is documented here.

GroupDocs.Viewer.Config.ViewerConfig

public string LocalesPath property has been removed 

This property has been removed. GroupDocs.Viewer no longer provides localization supports.

GroupDocs.Viewer.Converter.Options.ArchiveOptions

public class ArchiveOptions has been added
ArchiveOptions class allows specifying archive documents specific rendering options as explained in the article (given at the end of the page)..

public string FolderName property has been added
FolderName property of the ArchiveOptions class allows specifying the name of the folder inside Archive, to be rendered. More details can be found in the article (given at the end of the page)..

GroupDocs.Viewer.Converter.Options.HtmlOptions

public ArchiveOptions ArchiveOptions property has been added

ArchiveOptions class allows specifying archive documents specific rendering options as explained in the article (given at the end of the page).

GroupDocs.Viewer.Converter.Options.ImageOptions

public string FileExtension property compilation set to fail

This property is obsolete and will be removed after v19.3.

public ArchiveOptions ArchiveOptions property has been added

ArchiveOptions class allows specifying archive documents specific rendering options as explained in the article (given at the end of the page).

GroupDocs.Viewer.Domain.ArchiveFileData

public class ArchiveFileData has been added

This class represents archive specific FileData.

GroupDocs.Viewer.Domain.CachedDocumentDescription

public ArchiveOptions ArchiveOptions property has been added

ArchiveOptions class allows specifying archive documents specific rendering options as explained in the article (given at the end of the page).

 

GroupDocs.Viewer.Domain.CachedPageDescription

 

public ArchiveOptions ArchiveOptions property has been added

ArchiveOptions class allows specifying archive documents specific rendering options as explained in the article (given at the end of the page).

GroupDocs.Viewer.Domain.Containers.ArchiveDocumentInfoContainer

 ArchiveDocumentInfoContainer class provides archive documents specific information as explained in the article (given at the end of the page).

GroupDocs.Viewer.Domain.Containers.PdfDocumentInfoContainer

 

public class PdfDocumentInfoContainer class has been added


Check if source PDF document has restriction on printing

Since the version 19.3 GroupDocs.Viewer for .NET API enables to check if PDF document has restriction on printing.

Following example demonstrates how to retrieve document information and check if document has restriction on printing.

C# (Render document into PDF with security settings)

 

 

GroupDocs.Viewer.Domain.Html.HtmlResource

 

public ArchiveOptions ArchiveOptions property has been added

ArchiveOptions class allows specifying archive documents specific rendering options as explained in the article (given at the end of the page).

GroupDocs.Viewer.Domain.Options

 

public enum PdfFilePermissions enumeration has been added

public class PdfFileSecurity class has been added

PdfFileSecurity PdfFileSecurity { get; set; } property has been added to PdfFileOptions class

 

Specify owner password, user password and permissions when rendering into PDF

Since the version 19.3 GroupDocs.Viewer for .NET API enables to specify owner password, user password and PDF file permissions when rendering into PDF. API provides following settings:  

    • Owner password - Set owner password if password required to change the document permissions.
    • User password - Set user password if password required when opening a document.
    • PDF file permissions - Set permissions to allow or deny printing, modification and data extraction.

Following example demonstrates how to render document into PDF and set password for opening, password to change document permissions and permissions to deny printing

C# (Render document into PDF with security settings)

 

 

GroupDocs.Viewer.Domain.Options.DocumentInfoOptions

 

public ArchiveOptions ArchiveOptions property has been added

ArchiveOptions class allows specifying archive documents specific rendering options as explained in the article (given at the end of the page)

GroupDocs.Viewer.Domain.Options.PdfFileOptions

 

public ArchiveOptions ArchiveOptions property has been added.

ArchiveOptions class allows specifying archive documents specific rendering options as explained in the article (given at the end of the page).

GroupDocs.Viewer.Handler.Cache.ICacheDataHandler

 

public DateTime? GetLastModificationDate method  compilation is set to fail 

This property is obsolete and will be removed after v19.3. GroupDocs.Viewer will no longer rely on document last modification date while caching or retrieving render results from cache.

GroupDocs.Viewer.Handler.ViewerHtmlHandler

 

public ViewerHtmlHandler(ViewerConfig viewerConfig, CultureInfo cultureInfo) constructor compilation is set to fail

This constructor is obsolete and will be removed after v19.3. Please, instead, use the constructors that do not have CultureInfo argument.

public ViewerHtmlHandler(ViewerConfig viewerConfig, IInputDataHandler inputDataHandler, CultureInfo cultureInfo) constructor compilation is set to fail

This constructor is obsolete and will be removed after v19.3. Please, instead, use the constructors that do not have CultureInfo argument.

public ViewerHtmlHandler(ViewerConfig viewerConfig, IInputDataHandler inputDataHandler, ICacheDataHandler cacheDataHandler, CultureInfo cultureInfo) constructor compilation is set to fail

This constructor is obsolete and will be removed after v19.3. Please, instead, use the constructors that do not have CultureInfo argument.

public ViewerHtmlHandler(IFileStorage fileStorage, CultureInfo cultureInfo) constructor compilation is set to fail

This constructor is obsolete and will be removed after v19.3. Please, instead, use the constructors that do not have CultureInfo argument.

public ViewerHtmlHandler(ViewerConfig viewerConfig, IFileStorage fileStorage, CultureInfo cultureInfo) constructor compilation is set to fail

This constructor is obsolete and will be removed after v19.3. Please, instead, use the constructors that do not have CultureInfo argument.

GroupDocs.Viewer.Handler.ViewerImageHandler

 

public ViewerImageHandler(ViewerConfig viewerConfig, CultureInfo cultureInfo) constructor compilation is set to fail

This constructor is obsolete and will be removed after v19.3. Please, instead, use the constructors that do not have CultureInfo argument.

public ViewerImageHandler(ViewerConfig viewerConfig, IInputDataHandler inputDataHandler, CultureInfo cultureInfo) constructor compilation is set to fail

This constructor is obsolete and will be removed after v19.3. Please, instead, use the constructors that do not have CultureInfo argument.

public ViewerImageHandler(ViewerConfig viewerConfig, IInputDataHandler inputDataHandler, ICacheDataHandler cacheDataHandler, CultureInfo cultureInfo) constructor compilation is set to fail

This constructor is obsolete and will be removed after v19.3. Please, instead, use the constructors that do not have CultureInfo argument.

public ViewerImageHandler(IFileStorage fileStorage, CultureInfo cultureInfo) constructor compilation is set to fail

This constructor is obsolete and will be removed after v19.3. Please, instead, use the constructors that do not have CultureInfo argument.

public ViewerImageHandler(ViewerConfig viewerConfig, IFileStorage fileStorage, CultureInfo cultureInfo) constructor compilation is set to fail

This constructor is obsolete and will be removed after v19.3. Please, instead, use the constructors that do not have CultureInfo argument.

GroupDocs.Viewer.Localization.ILocalizationHandler

 

public interface ILocalizationHandler compilation is set to fail

This interface is obsolete and will be removed after version 19.3. The exception localization feature no longer provided.

GroupDocs.Viewer.Localization.LocalizedStringKeys

 

public static class LocalizedStringKeys and all its members have been set obsolete

This class and its members are obsolete and will be removed after version 19.3. The exception localization feature no longer provided.

Rendering Archive documents

Introduction

Since version 19.2 GroupDocs.Viewer for .Net API supports rendering Archive documents. Rendering into HTML provides one HTML page with the list of all items (files and folders) in the root of the archive. Rendering into PDF and image provides one or more pages, depending on a number of items (files or folders) in the archive, each output image or PDF page contains a maximum of 10 items. By default, only the items from the root of the archive are rendered. Since version 19.3, it is possible to obtain the list of contained folders and render the content from those.

Obtaining the list of folders from the Archive

The following example shows how to obtain the list of folders from the root of the archive:

Retrieving the list of root folders from archive documents
C#

 

When you need to obtain the list of folders contained in a certain folder inside the archive, you have to use ArchiveOptions.FolderName option (available since version 19.3) as shown in the example below.  For instance, let's assume there is a folder named 'FirstLevelFolder' in the root of the archive, then if you need to get the list of folders inside this 'FirstLevelFolder', set the value 

ArchiveOptions.FolderName = "FirstLevelFolder";

In case you need to obtain a list of folders from 'SecondLevelFolder' that resides in 'FirstLevelFolder' then set the value using '/' path delimiter character as shown in the following example:

Retrieving the list of folders from the certain folder inside the archive
C#

 

Rendering certain folders from the archive

By default items from the root of the archive are rendered. When you have obtained the list of folders as explained in the section above, you are now able to render the specified folder as shown in the examples below.

Rendering specified folder into image (or HTML)
C#
Rendering specified folder into PDF
C#
Labels
  • No labels