GleamTech.DocumentUltimate 6.4.0

• .NETFramework 4.6.1

  • GleamTech.Common (>= 5.4.0)

• .NETStandard 2.0

  • GleamTech.Common (>= 5.4.0)
  • System.Drawing.Common (>= 4.7.0)
  • System.Security.Cryptography.Xml (>= 4.7.0)
  • System.Security.Permissions (>= 4.7.0)
  • System.Text.Encoding.CodePages (>= 4.7.0)

## Version 6.4.0 - April 20, 2022

 - Redesigned DocumentViewer API (especially file input mechanism), for easier usage and better discoverability.
   Now it's easier and more compact to load a document from a URL, Database, Stream, Memory, AzureBlob, AmazonS3 etc.
   See Examples section here, to see full code for new ways to load a document:
   https://docs.gleamtech.com/documentultimate/html/P_GleamTech_DocumentUltimate_AspNet_UI_DocumentViewer_Document.htm

   API changes:
   - Changes in DocumentViewer and DocumentViewerControl and related classes:
     - Removed DocumentLocation, DocumentHandlerType, DocumentHandlerParameters, DocumentSource properties.
     - Changed type of Document property from string to FileProvider.
     - Moved HighQualityEnabled, Password, Watermarks, Attachments, InputOptions, DownloadUrl, DownloadFileName properties under DocumentOptions property.
     - Moved DocumentFormat property under DocumentOptions property with new name Format.
     - Added Page prefix to LayoutMode, FitMode, ZoomLevel properties.
     - Added DocumentViewerPage prefix to FitMode, LayoutMode classes.
     - Added DocumentViewer prefix to SearchOptions, MatchOptions, PrintOptions, MobileMode classes.
     - Renamed SinglePageRotationEnabled to PageRotationMode and changed type from bool to DocumentViewerPageRotationMode.
   - Changes in DocumentOptions class:
     - Moved DocumentOptions to GleamTech.DocumentUltimate.AspNet.UI and inherited new class DocumentCacheOptions.
     - Removed Document, DocumentLocation, DocumentHandlerType, DocumentHandlerParameters, DocumentSource properties.
     - Renamed DocumentFormat property to Format.
   - Changes in DocumentCache and related classes:
     - Moved DocumentCache and DocumentCacheInfo to GleamTech.DocumentUltimate.Caching namespace
     - Added new class DocumentCacheOptions.
     - Renamed GetCacheInfo method to CreateCacheInfo.
     - Changed CreateCacheInfo(DocumentOptions documentOptions) method signature to CreateCacheInfo(FileProvider document, DocumentOptions documentOptions)
     - Changed PreCacheDocument(DocumentOptions documentOptions) method signature to PreCacheDocument(FileProvider document, DocumentOptions documentOptions)

 - **Added:** GleamTech.FileProviders namespace which includes these built-in file providers:
   FileSystemFileProvider, UrlFileProvider, StreamFileProvider,
   MemoryFileProvider, DatabaseFileProvider,
   AssemblyResourceFileProvider, TemporaryFileProvider.

   Base class FileProvider can be implemented to provide a custom way of reading and/or writing files.
   FileProvider is an abtraction for file locations just like GleamTech.FileSystems.Location is for folder locations.
   FileProvider is not a full fledged file system like GleamTech.FileSystems.FileSystem, it only offers
   GetInfo, OpenRead and OpenWrite methods to be used for basic file input and output in GleamTech components.
   One of the built-in implemented classes, FileSystemFileProvider allows to use any built-in file system
   from GleamTech.FileSystems (or custom ones).

 - **Added:** Nested attachments are now supported for Email and Pdf formats.
   - Attachments will use the same PdfOutputOptions.Watermarks and PdfOutputOptions.FastWebViewEnabled properties   
     from root container document for PDFs generated for attachments.
   - Some emails may contain extensionless attachments which are nested emails, these are "message/rfc822" attachments.
     Now .eml extension will be added to these attachments so that they can be converted and displayed in DocumentViewer.

 - **Added:** Last modified date of the attachments in PDF Portfolios can now be read and written.
   Added AttachmentInfo.DateModified and Attachment.DateModified properties.
   PDF Portfolios can read and create filespec with ModDate now.

 - **Improved:** DocumentViewer UI:
   - Tabs on the left side pane will be activated on document load, automatically according to this priority (from lowest to highest):
     - If there are bookmarks, Bookmarks tab will be activated.
     - If there are attachments, Attachments tab will be activated.
     - If there is a search term, Search tab will be activated.
   - Fixed text-wrapping in Bookmarks and Attachments tree panels for better width and look.
   - In attachment tree nodes, file size will not be displayed next to file name (it's already displayed on the attachment tooltip).
   - On attachment tooltips, desciption will shown as "DispositionType (ContentType)" e.g "attachment (application/octet-stream)".
   - On attachment tooltips, the last modified date will also be shown (for PDF Portfolio and Email attachments when available).
   
 - **Improved:** Updated docs, added better example codes.