Master-Dokumentsignierung und -überprüfung mit GroupDocs.Signature für .NET

So meistern Sie die Dokumentsignierung und -überprüfung mit GroupDocs.Signature für .NET

In der heutigen digitalen Landschaft sind effiziente Lösungen zur Dokumentensignatur für die Verwaltung von Verträgen, Vereinbarungen und anderen Rechtsdokumenten unerlässlich. Die Automatisierung dieses Prozesses spart Zeit und reduziert Fehler. GroupDocs.Signature für .NET bietet eine robuste Lösung zur Optimierung der Textsignaturverwaltung in Ihren Anwendungen. Dieser umfassende Leitfaden führt Sie durch die Funktionen von GroupDocs.Signature für .NET, einschließlich Signieren, Überprüfen, Suchen, Aktualisieren und Löschen von Textsignaturen.

Was Sie lernen werden

So unterschreiben Sie Dokumente mit anpassbaren Textsignaturen
Techniken zur effektiven Überprüfung signierter Dokumente
Methoden zum Suchen nach vorhandenen Textsignaturen in Dokumenten
Schritte zum Aktualisieren und Löschen von Textsignaturen nach Bedarf
Best Practices zur Optimierung der Leistung und des Speichermanagements

Beginnen wir mit der Besprechung der Voraussetzungen.

Voraussetzungen

Stellen Sie vor dem Beginn sicher, dass Ihre Entwicklungsumgebung mit den erforderlichen Tools eingerichtet ist:

Erforderliche Bibliotheken und Abhängigkeiten

GroupDocs.Signature für .NET: Mit dieser Bibliothek können Sie Ihren Anwendungen Signaturfunktionen hinzufügen.
.NET Framework 4.6.1 oder höher (oder .NET Core 2.x+)

Anforderungen für die Umgebungseinrichtung

Sie benötigen eine C#-Entwicklungsumgebung wie Visual Studio und eine Internetverbindung, um die erforderlichen Pakete herunterzuladen.

Erforderliche Kenntnisse

Kenntnisse der grundlegenden C#-Programmierkonzepte sind empfehlenswert. Wenn Sie GroupDocs.Signature für .NET noch nicht kennen, ist das kein Problem – diese Anleitung führt Sie Schritt für Schritt durch die einzelnen Schritte.

Einrichten von GroupDocs.Signature für .NET

Um zu beginnen, müssen Sie die Bibliothek GroupDocs.Signature in Ihrem Projekt installieren. So geht’s:

Installation über .NET CLI

dotnet add package GroupDocs.Signature

Paket-Manager-Konsole

Install-Package GroupDocs.Signature

NuGet-Paket-Manager-Benutzeroberfläche

Öffnen Sie Ihr Projekt in Visual Studio.
Navigieren Sie zu Werkzeuge > NuGet-Paket-Manager > Verwalten von NuGet-Paketen für die Lösung.
Suchen Sie nach „GroupDocs.Signature“ und installieren Sie die neueste Version.

Schritte zum Lizenzerwerb

Kostenlose Testversion: Beginnen Sie mit einer kostenlosen Testversion, indem Sie sie von herunterladen Kostenlose Testversionen von GroupDocs.
Temporäre Lizenz: Erwerben Sie eine temporäre Lizenz, um alle Funktionen zu testen unter Temporäre Lizenz.
Kaufen: Für die weitere Nutzung erwerben Sie eine Lizenz von GroupDocs-Kaufseite.

Grundlegende Initialisierung und Einrichtung

Initialisieren Sie GroupDocs.Signature nach der Installation in Ihrem Projekt wie folgt:

using GroupDocs.Signature;

// Initialisieren Sie die Signaturinstanz mit dem Dokumentpfad.
Signature signature = new Signature("path/to/your/document.pdf");

Nachdem Sie nun alles eingerichtet haben, sehen wir uns an, wie Sie GroupDocs.Signature für verschiedene Funktionen nutzen können.

Implementierungshandbuch

Dokument mit Textsignatur unterzeichnen

Mit dieser Funktion können Sie einem Dokument Textsignaturen hinzufügen. Im Folgenden erfahren Sie, wie Sie die Signaturen aufschlüsseln:

Überblick

Sie können das Erscheinungsbild und die Position Ihrer Textsignatur mithilfe verschiedener Optionen wie Schriftgröße, Farbe, Ausrichtung usw. anpassen.

Schrittweise Implementierung

Schritt 1: Definieren Sie den Dateipfad und den Ausgabeort.

string filePath = "YOUR_DOCUMENT_DIRECTORY"; // Pfad zum Originaldokument
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedDocument.docx");

Schritt 2: Erstellen Sie eine Textsignatur mit TextSignOptions.

using (Signature signature = new Signature(filePath))
{
    TextSignOptions signOptions = new TextSignOptions("John Smith")
    {
        VerticalAlignment = GroupDocs.Signature.Options.VerticalAlignment.Top,
        HorizontalAlignment = GroupDocs.Signature.Options.HorizontalAlignment.Center,
        Width = 100,
        Height = 40,
        Margin = new Padding(20),
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" }
    };

Schritt 3: Unterschreiben Sie das Dokument und geben Sie die Ergebnisse aus.

    SignResult signResult = signature.Sign(outputFilePath, signOptions);
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signed Text Signature: Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}

Wichtige Konfigurationsoptionen

VerticalAlignment und HorizontalAlignmentSteuern Sie, wo die Signatur auf der Seite angezeigt wird.
Schriftart: Passen Sie Schriftgröße und -stil für Ihre Textsignatur an.

Dokument auf Textsignatur prüfen

Durch die Verifizierung wird sichergestellt, dass ein Dokument wie vorgesehen signiert wurde. So wird sie implementiert:

Überblick

Überprüfen Sie vorhandene Textsignaturen in Ihren Dokumenten, um deren Authentizität und Integrität zu bestätigen.

Schrittweise Implementierung

Schritt 1: Geben Sie den Dateipfad des signierten Dokuments an.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Pfad zum signierten Dokument

Schritt 2: Erstellen Sie Überprüfungsoptionen mit TextVerifyOptions.

using (Signature signature = new Signature(filePath))
{
    TextVerifyOptions verifyOptions = new TextVerifyOptions()
    {
        AllPages = false,
        PageNumber = 1,
        Text = "John Smith",
        MatchType = GroupDocs.Signature.Options.TextMatchType.Exact
    };

Schritt 3: Überprüfen Sie das Dokument.

    VerificationResult verifyResult = signature.Verify(verifyOptions);
    if (verifyResult.IsValid)
    {
        Console.WriteLine("Document was verified successfully!");
    }
    else
    {
        Console.WriteLine("Document failed verification process.");
    }
}

Tipps zur Fehlerbehebung

Stellen Sie sicher, dass Text Die Eigenschaft stimmt genau mit dem Inhalt des Dokuments überein.
Überprüfen Sie, ob PageNumber entspricht der richtigen Seite mit der Unterschrift.

Dokument nach Textsignatur durchsuchen

Mit dieser Funktion können Sie Textsignaturen in Ihren Dokumenten effizient finden.

Überblick

Durchsuchen Sie alle oder ausgewählte Seiten eines Dokuments, um bestimmte Textsignaturen zu finden.

Schrittweise Implementierung

Schritt 1: Definieren Sie den Dateipfad.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Pfad zum signierten Dokument

Schritt 2: Verwenden TextSearchOptions für die Suche.

using (Signature signature = new Signature(filePath))
{
    TextSearchOptions searchOptions = new TextSearchOptions()
    {
        AllPages = true,
        MatchType = GroupDocs.Signature.Options.TextMatchType.Exact,
        Text = "John Smith"
    };

Schritt 3: Suche ausführen.

    List<TextSignature> signatures = signature.Search<TextSignature>(searchOptions);
    foreach (TextSignature textSignature in signatures)
    {
        if (textSignature != null)
        {
            Console.WriteLine($"Found Text signature at page {textSignature.PageNumber} with type [{textSignature.SignatureImplementation}] and text '{textSignature.Text}'. Location: {textSignature.Left}-{textSignature.Top}. Size is {textSignature.Width}x{textSignature.Height}.");
        }
    }
}

Dokumenttextsignatur aktualisieren

Ändern Sie bei Bedarf vorhandene Textsignaturen in einem Dokument.

Überblick

Passen Sie die Eigenschaften vorhandener Textsignaturen an, beispielsweise Größe und Position.

Schrittweise Implementierung

Schritt 1: Geben Sie den Dateipfad und die Signatur-IDs an.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Pfad zum signierten Dokument
List<string> signatureIds = new List<string>(); // Angenommen, diese Liste ist mit gültigen Signatur-IDs gefüllt

Schritt 2: Erstellen TextSignature Objekte für Aktualisierungen.

using (Signature signature = new Signature(filePath))
{
    foreach (var item in signatureIds)
    {
        TextSignature temp = new TextSignature(item)
        {
            Width = 150,
            Height = 50,
            HorizontalAlignment = GroupDocs.Signature.Options.HorizontalAlignment.Right
        };

Schritt 3: Dokument aktualisieren.

        SignResult signResult = signature.UpdateSignatures(temp);
        if (signResult.Succeeded.Count > 0)
        {
            Console.WriteLine($"Updated Text Signature: Id:{temp.SignatureId}");
        }
    }
}

Wichtige Konfigurationsoptionen

Breite und Höhe: Passen Sie die Größe der Signatur an.
Horizontale Ausrichtung: Steuern Sie, wo die aktualisierte Signatur auf der Seite angezeigt wird.

Abschluss

In dieser Anleitung haben Sie gelernt, wie Sie mit GroupDocs.Signature für .NET Textsignaturen in Dokumenten signieren, verifizieren, suchen, aktualisieren und löschen. Diese Funktionen sind unerlässlich für die Automatisierung digitaler Signaturprozesse in Ihren Anwendungen. Ausführlichere Informationen und erweiterte Optionen finden Sie im offizielle Dokumentation.