GroupDocs.Signature for .NET 21.9 Release Notes

Major Features

This release contains new features with QR Code embedded objects and few optimization on Document modification process that will allow to skip unnecessary document saving when Update and Delete method had no effect. Below the list of most notable changes in release of GroupDocs.Signature for .NET 21.9:

  • Signature Settings has new properties to adjust document saving when modifications method had no effect.
  • New QR Code type crypto currency trasnfer for embedded object was added.
  • Fixed issue with image document processing.
  • Implemented ability to skip document saving based on new settings.

Full List of Issues Covering all Changes in this Release

KeySummaryIssue Type
SIGNATURENET-3634Implement new Signature setting to skip document saving when Delete method has no effectFeature
SIGNATURENET-3633Implement new Signature setting to skip document saving when Update method has no effectFeature
SIGNATURENET-3628Implement new QR Code type of Crypto Currency walletsFeature
SIGNATURENET-3577Parameter is not valid for Image DocumentImprovement
SIGNATURENET-3576Skip Document saving when Delete method had no effectImprovement
SIGNATURENET-3627Skip Document saving when Update method had no effectBug

Public API and Backward Incompatible Changes

Public class SignatureSettings was updated with new properties that allow to skip document saving when modification methods had no effect

Public class SignatureSettings was updated with properties

  • property bool [SaveDocumentOnEmptyUpdate] that allows to specify if document should not be saved when Update method had no affected signatures. By default this value equals to true.
  • property bool [SaveDocumentOnEmptyDelete] that allows to specify if document should not be saved when Delete method had no affected signatures. By default this value equals to true.

New properties of SignatureSettings class

    public class SignatureSettings
    {
        /// <summary>
        /// Gets or sets flag to resave source document when Update method has no signatures to update.
        /// If this flag is set to true (by default) document will be saving with corresponding history process log (date and operation type) 
        //  even if Update method has no signatures to update.
        /// When this flat is set to false source document will not be modified at all.
        /// </summary>
        public bool SaveDocumentOnEmptyUpdate { get; set; } = true;

        /// <summary>
        /// Gets or sets flag to resave source document when Delete method has no affected signatures to remove.
        /// If this flag is set to true (by default) document will be saving with corresponding history process log (date and operation type) even if Delete method has no signatures to remove.
        /// When this flat is set to false source document will not be modified at all.
        /// </summary>
        public bool SaveDocumentOnEmptyDelete { get; set; } = true;
   }

New public enumeration CryptoCurrencyType was added to specify various cryptocurrency types

This enumeration keeps supported cryptocurrency types.

New public enumeration

    /// <summary>
    /// Represents Cryptocurrency type.
    /// </summary>
    public enum CryptoCurrencyType
    {
        /// <summary>Represents custom crypto currency type.</summary>
        Custom = 0,

        /// <summary>Represents Bitcoin crypto currency type.</summary>
        Bitcoin = 1,

        /// <summary>Represents Bitcoin Cash crypto currency type.</summary>
        BitcoinCash = 2,

        /// <summary>Represents Litecoin crypto currency type.</summary>
        Litecoin = 3,

        /// <summary>Represents Ethereum crypto currency type.</summary>
        Ethereum = 4,

        /// <summary>Represents Dash crypto currency type.</summary>
        Dash = 5,
    }
}

New public class CryptoCurrencyTransfer was added to keep properties of cryptocurrency data for QR-code embedded object

This class contains following properties

  • CryptoCurrencyType Type - the type of cryptocurency trasnfer CryptoCurrencyType
  • decimal Amount is the value as amount of trasnfer.
  • string Address is the address of the trasnfer.
  • string Message to keep transfer message.
  • string CustomType to specify cryptocurrency name in case of custom cryptocurrency type.

New public class CryptoCurrencyTransfer

    /// <summary>
    /// Represents Crypto currency transfer (reciever or transfer) for QR-Code.
    /// </summary>
    public class CryptoCurrencyTransfer
    {
        /// <summary>
        /// Gets or sets one of supported crypto currency type.
        /// </summary>
        public CryptoCurrencyType Type { get; set; } = CryptoCurrencyType.Bitcoin;

        /// <summary>
        /// Gets or sets transfer amount.
        /// </summary>
        public decimal Amount { get; set; }

        /// <summary>
        /// Gets or sets crypto currency public address.
        /// </summary>
        public string Address { get; set; }

        /// <summary>
        /// Gets or sets optional transfer message.
        /// </summary>
        public string Message { get; set; }

        /// <summary>
        /// Gets or sets optional transfer message.
        /// </summary>
        public string CustomType { get; set; }
    }
}