GroupDocs.Signature for .NET 23.6 Release Notes

/// <summary>
/// Search multi-layer image document for signatures.
/// This example provided for formats like DICOM
/// </summary>
using (Signature signature = new Signature("signed.dcm"))
{
    // setup search options
    QrCodeSearchOptions searchOptions = new QrCodeSearchOptions()
    {
        // enable grabbing image content feature
        ReturnContent = true,
        // specify exact image type to be returned
        ReturnContentType = FileType.PNG
    };
    // search multi-layer document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(searchOptions);
    Console.WriteLine($"\nSource document ['{fileName}'] contains following QR-code signature(s).");
    // output signatures
    foreach (QrCodeSignature qrSignature in signatures)
    {
        // due to multi-layers each signature will contain the page number
        Console.Write($"Found Image signature at page {qrSignature.PageNumber} and id# {qrSignature.SignatureId}.");
        Console.WriteLine($"Location at {qrSignature.Left}-{qrSignature.Top}. Size is {qrSignature.Width}x{qrSignature.Height}.");
    }
}

/// <summary>
/// Obtain information from multi-layer image document.
/// This example provided for formats like DICOM
/// </summary>
using (Signature signature = new Signature("signed.dcm"))
{
    IDocumentInfo documentInfo = signature.GetDocumentInfo();
    Console.WriteLine($"Document properties {Path.GetFileName(filePath)}:");
    Console.WriteLine($" - format : {documentInfo.FileType.FileFormat}");
    Console.WriteLine($" - extension : {documentInfo.FileType.Extension}");
    Console.WriteLine($" - size : {documentInfo.Size}");
    Console.WriteLine($" - page count : {documentInfo.PageCount}");
    foreach (PageInfo pageInfo in documentInfo.Pages)
    {
        Console.WriteLine($" - page-{pageInfo.PageNumber} Width {pageInfo.Width}, Height {pageInfo.Height}");
    }
}

/// <summary>
/// Sign multi-layer image document.
/// </summary>
using (var signature = new Signature("sample.dcm"))
{
    var options = new QrCodeSignOptions("Patient #36363393. R: No-Issues")
    {
        // set signature position 
        Left = 10, Top = 10,
        // set signature rectangle
        Width = 200, Height = 200
    };
    // sign document to file
    SignResult signResult = signature.Sign(outputFilePath, options);
    Console.WriteLine($"\nDocument signed with {signResult.Succeeded.Count} signatures");
    Console.WriteLine("\nList of newly created signatures:");
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"{temp.SignatureType} at page #{temp.PageNumber}: Id:{temp.SignatureId}.");
    }
}

/// <summary>
/// Search if certificate contain specific string from the serial number.
/// </summary>
using (Signature signature = new Signature(certificatePath, loadOptions))
{
    CertificateSearchOptions options = new CertificateSearchOptions()
    {
        // check the serial number
        Text = "AAD0D15C628A",
        // find exact math
        MatchType = TextMatchType.Contains,
    };

    // search for certificate data
    List<MetadataSignature> result = signature.Search<MetadataSignature>(options);
    if (result.Count>0)
    {
        Console.WriteLine("\nCertificate contains following search results");
        foreach (MetadataSignature temp in result)
        {
            Console.WriteLine($"\t\t-{temp.Name} - {temp.Value}");
        }
    }
    else
    {
        Helper.WriteError("\nCertificate failed search process.");
    }
}

/// <summary>
/// Support Succeeded and Failed list as result of processing archives
/// </summary>
using (var signature = new Signature("sample.zip"))
{
    // create sign options
    var options = new TextSignOptions("signed!")
    {
        // set signature position
        Left = 100,
        Top = 100
    };
    // sign archive to new zip file
    SignResult result = signature.Sign("output.zip", options);
    // analyze the failed documents
    foreach (DocumentResultSignature document in result.Failed)
    {
        Console.WriteLine($"Document {document.FileName} processed with error: {document.ErrorMessage}");
    }
}