GroupDocs.Signature für .NET meistern: Dokumentinformationen effizient extrahieren und anzeigen

Einführung

Möchten Sie effizient umfassende Details aus Dokumenten in Ihren Anwendungen extrahieren? Ob es um die Verwaltung von Verträgen, Vereinbarungen oder mehrseitigen PDFs geht – eine robuste Lösung ist unerlässlich. GroupDocs.Signature für .NET bietet leistungsstarke Funktionen zur Optimierung der Dokumentenanalyse durch Abrufen und Anzeigen von Elementen wie Formularfeldern, Signaturen, Metadaten und mehr. Dieses Tutorial führt Sie durch die Nutzung dieser Funktionen zur Verbesserung der Funktionalität Ihrer Anwendung.

Was Sie lernen werden:

  • So rufen Sie detaillierte Dokumentinformationen mit GroupDocs.Signature für .NET ab
  • Anzeige verschiedener Signaturtypen und Formularfelddetails
  • Extrahieren von Metadaten und seitenspezifischen Attributen

Lassen Sie uns die Voraussetzungen überprüfen, bevor wir mit der Implementierung beginnen.

Voraussetzungen

Bevor Sie GroupDocs.Signature für .NET nutzen, stellen Sie sicher, dass Ihre Umgebung korrekt eingerichtet ist. Dieses Tutorial setzt Kenntnisse in C# und Grundkenntnisse der Dokumentverarbeitung voraus.

Erforderliche Bibliotheken und Abhängigkeiten

  • GroupDocs.Signature für .NET: Die primäre Bibliothek, die wir verwenden werden.
  • .NET Framework oder .NET Core: Abhängig von Ihrem Projekt-Setup.

Umgebungseinrichtung

Stellen Sie sicher, dass Sie über eine Entwicklungsumgebung mit Visual Studio oder einer anderen geeigneten IDE verfügen, die .NET-Projekte unterstützt.

Erforderliche Kenntnisse

  • Grundlegende Kenntnisse der C#-Programmierung.
  • Vertrautheit mit Dokumenttypen (PDF, Word, Excel) und deren Eigenschaften.

Einrichten von GroupDocs.Signature für .NET

Um GroupDocs.Signature für .NET zu verwenden, müssen Sie die Bibliothek installieren. Hier sind mehrere Methoden:

Installationsanweisungen

Verwenden der .NET-CLI:

dotnet add package GroupDocs.Signature

Verwenden der Package Manager-Konsole:

Install-Package GroupDocs.Signature

NuGet-Paket-Manager-Benutzeroberfläche: Suchen Sie im NuGet-Paket-Manager nach „GroupDocs.Signature“ und installieren Sie die neueste Version.

Lizenzerwerb

Um GroupDocs.Signature voll auszunutzen, sollten Sie den Erwerb einer Lizenz in Erwägung ziehen:

  • Kostenlose Testversion: Beginnen Sie mit einer kostenlosen Testversion, um die Funktionen zu erkunden.
  • Temporäre Lizenz: Erhalten Sie eine temporäre Lizenz für erweiterte Tests.
  • Kaufen: Kaufen Sie eine Volllizenz für den Produktionseinsatz.

Sobald es installiert und lizenziert ist, initialisieren Sie Ihr Projekt, indem Sie die GroupDocs.Signature-Umgebung wie unten gezeigt einrichten:

using System;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;

public class GetDocumentInfoFeature
{
    public static void Run()
    {
        // Definieren Sie den Dateipfad für das Dokument, das Sie analysieren möchten
        string filePath = "YOUR_DOCUMENT_DIRECTORY\Sample_Signed_Multi_Document.pdf";  // Ersetzen Sie es durch Ihren tatsächlichen Dokumentpfad
        
        SignatureSettings signatureSettings = new SignatureSettings
        {
            IncludeStandardMetadataSignatures = true
        };

        using (Signature signature = new Signature(filePath, signatureSettings))
        {
            IDocumentInfo documentInfo = signature.GetDocumentInfo();
            // Hier werden weitere Operationen durchgeführt...
        }
    }
}

Implementierungshandbuch

Nachdem die Einrichtung abgeschlossen ist, wollen wir untersuchen, wie verschiedene Funktionen von GroupDocs.Signature für .NET implementiert werden.

Abrufen und Anzeigen grundlegender Dokumenteigenschaften

Überblick: Extrahieren Sie wichtige Eigenschaften wie Dateiformat, Größe und Seitenzahl.

Schrittweise Implementierung:

  1. Signaturobjekt initialisieren: Erstellen Sie eine Instanz des Signature Klasse mit dem Pfad Ihres Dokuments.
  2. GetDocumentInfo-Methode: Verwenden Sie die GetDocumentInfo() Methode, um detaillierte Informationen zum Dokument abzurufen.
  3. Dokumenteigenschaften anzeigen: Grundlegende Eigenschaften wie Format, Erweiterung und Größe ausgeben mit Console.WriteLine zu Debugging- oder Protokollierungszwecken.
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}");

Informationen zu jeder Dokumentseite anzeigen

Überblick: Tauchen Sie tiefer ein, indem Sie Informationen zu jeder Seite im Dokument abrufen und anzeigen.

Schrittweise Implementierung:

  1. Durch Seiten iterieren: Durchschleifen documentInfo.Pages um auf einzelne Seitendetails wie Breite und Höhe zuzugreifen.
foreach (PageInfo pageInfo in documentInfo.Pages)
{
    Console.WriteLine($" - page-{pageInfo.PageNumber} Width {pageInfo.Width}, Height {pageInfo.Height}");
}

Informationen zu Formularfeldsignaturen anzeigen

Überblick: Extrahieren und Anzeigen von Informationen zu Formularfeldern im Dokument.

Schrittweise Implementierung:

  1. Zugriff auf Formularfelder: Verwenden documentInfo.FormFields um alle im Dokument vorhandenen Formularfeldsignaturen abzurufen.
  2. Details jedes Formularfelds anzeigen: Durchlaufen Sie jedes Formularfeld und geben Sie dessen Typ, Namen und Wert aus.
Console.WriteLine($"Document Form Fields information: count = {documentInfo.FormFields.Count}");
foreach (FormFieldSignature formField in documentInfo.FormFields)
{
    Console.WriteLine($" - type #{formField.Type}: Name: {formField.Name} Value: {formField.Value}");
}

Verschiedene Signaturinformationen anzeigen

Überblick: Informationen zu Text-, Bild-, Digital-, Barcode-, QR-Code-, Formularfeld- und Metadatensignaturen abrufen und anzeigen.

Implementierungsschritte:

  • Textsignaturen: Zugang documentInfo.TextSignatures um Details zu jeder Textsignatur zu erhalten, einschließlich ID, Ort, Größe und Erstellungsdatum.
Console.WriteLine($"Document Text signatures: {documentInfo.TextSignatures.Count}");
foreach (TextSignature textSignature in documentInfo.TextSignatures)
{
    Console.WriteLine($" - #{textSignature.SignatureId}: Text: {textSignature.Text} Location: {textSignature.Left}x{textSignature.Top}. Size: {textSignature.Width}x{textSignature.Height}. CreatedOn/ModifiedOn: {textSignature.CreatedOn.ToShortDateString()} / {textSignature.ModifiedOn.ToShortDateString()}");
}
  • Bildsignaturen: Ähnlich wie bei Textsignaturen verwenden Sie documentInfo.ImageSignatures für Details wie Größe und Format von Bildsignaturen.
Console.WriteLine($"Document Image signatures: {documentInfo.ImageSignatures.Count}");
foreach (ImageSignature imageSignature in documentInfo.ImageSignatures)
{
    Console.WriteLine($" - #{imageSignature.SignatureId}: Size: {imageSignature.Size} bytes, Format: {imageSignature.Format}. CreatedOn/ModifiedOn: {imageSignature.CreatedOn.ToShortDateString()} / {imageSignature.ModifiedOn.ToShortDateString()}");
}
  • Digitale Signaturen: Für digitale Signaturen verwenden Sie documentInfo.DigitalSignatures um Signatur-IDs und Zeitstempel zu extrahieren.
Console.WriteLine($"Document Digital signatures: {documentInfo.DigitalSignatures.Count}");
foreach (DigitalSignature digitalSignature in documentInfo.DigitalSignatures)
{
    Console.WriteLine($" - #{digitalSignature.SignatureId}. CreatedOn/ModifiedOn: {digitalSignature.CreatedOn.ToShortDateString()} / {digitalSignature.ModifiedOn.ToShortDateString()}");
}
  • Barcode- und QR-Code-Signaturen: Verwenden documentInfo.BarcodeSignatures Und documentInfo.QrCodeSignatures um Barcode- bzw. QR-Code-Details zu erfassen.
Console.WriteLine($"Document Barcode signatures: {documentInfo.BarcodeSignatures.Count}");
foreach (BarcodeSignature barcodeSignature in documentInfo.BarcodeSignatures)
{
    Console.WriteLine($" - #{barcodeSignature.SignatureId}: Type: {barcodeSignature.EncodeType?.TypeName}. Text: {barcodeSignature.Text}");
}

Console.WriteLine($"Document QR Code signatures: {documentInfo.QrCodeSignatures.Count}");
foreach (QrCodeSignature qrCodeSignature in documentInfo.QrCodeSignatures)
{
    Console.WriteLine($" - #{qrCodeSignature.SignatureId}: Type: {qrCodeSignature.EncodeType?.TypeName}. Text: {qrCodeSignature.Text}");
}

Abschluss

In diesem Tutorial haben Sie gelernt, wie Sie GroupDocs.Signature für .NET nutzen, um umfassende Dokumentinformationen effizient zu extrahieren und anzuzeigen. Diese Kenntnisse verbessern die Fähigkeit Ihrer Anwendung, Dokumente präzise und einfach zu verwalten.

Nächste Schritte:

  • Entdecken Sie zusätzliche Funktionen von GroupDocs.Signature.
  • Implementieren Sie die Signaturvalidierung in Ihren Anwendungen.
  • Integrieren Sie diese Funktionalität in größere Workflows zur automatisierten Dokumentenverarbeitung.