GroupDocs.Signature for .NET 20.1 Release Notes

Major Features

Below is the list of most notable changes in release of GroupDocs.Signature for .NET 20.1:

• Legacy API was removed from product
• Introduced new digital signature XML Advanced Electronic Signatures type for Spreadsheet documents
• Added new type of annotation

Full List of Issues Covering all Changes in this Release

Public API and Backward Incompatible Changes

1. GroupDocs.Signature.Domain.XAdESType

   New public enumeration type XAdESType was added. This type describes possible values of XML Advanced Electronic Signatures types.

   At this moment enumeration contains two options None and XAdES.

   Enumeration of XML Advanced Electronic Signatures types

   /// <summary>
   /// Type of XML Advanced Electronic Signature (XAdES).
   /// </summary>
   public enum XAdESType
   {
       /// <summary>
       /// XAdES is off.
       /// </summary>
       None = 0,
       /// <summary>
       /// Basic XAdES.
       /// </summary>
       XAdES = 1
   }
   

2. GroupDocs.Signature.Options.DigitalSignOptions
   Public class DigitalSignOptions was extended with new enumeration property XAdESType to specify if digital signature should be XAdES type. See enumeration type XAdESType.

   XAdESType property

   /// <summary>
   /// XAdES type <see cref="XAdESType"/>. Defaule value is None (XAdES is off).
   /// At this moment XAdES signature type is supported only for Spreadsheet documents.
   /// </summary>
   public XAdESType XAdESType { get; set; } = XAdESType.None;
   

   This new property is supported only for Spreadsheets documents. For any other document types this field value will be ignored.

   Example:

   Following example demonstrates creating XAdES Digital signature for Spreadsheet document.

   Signing Spreadsheet document with XAdES signature

   using (Signature signature = new Signature("sample.xlsx"))
   {
       DigitalSignOptions options = new DigitalSignOptions("certificate.pfx")
       {
           // set XAdES type
           XAdESType = XAdESType.XAdES,
           // certificate password
           Password = "1234567890",
           // digital certificate details
           Reason = "Sign",
           Contact = "JohnSmith",
           Location = "Office1"
       };
       SignResult signResult = signature.Sign("output.xlsx", options);
       Console.WriteLine($"Document was signed successfully with {signResult.Succeeded.Count} signature(s).\nFile saved at {outputFilePath}.");    
   }