Podpisywanie i weryfikacja dokumentu głównego za pomocą GroupDocs.Signature dla platformy .NET

Jak opanować podpisywanie i weryfikację dokumentów za pomocą GroupDocs.Signature dla platformy .NET

W dzisiejszym cyfrowym świecie, efektywne rozwiązania do podpisywania dokumentów są kluczowe dla zarządzania umowami, porozumieniami i wszelką dokumentacją prawną. Automatyzacja tego procesu oszczędza czas i zmniejsza liczbę błędów. GroupDocs.Signature dla .NET oferuje solidne rozwiązanie usprawniające zarządzanie podpisami tekstowymi w aplikacjach. Ten kompleksowy przewodnik zapozna Cię z funkcjami GroupDocs.Signature dla platformy .NET, w tym z podpisywaniem, weryfikacją, wyszukiwaniem, aktualizacją i usuwaniem podpisów tekstowych.

Czego się nauczysz

Jak podpisywać dokumenty za pomocą konfigurowalnych podpisów tekstowych
Techniki skutecznej weryfikacji podpisanych dokumentów
Metody wyszukiwania istniejących podpisów tekstowych w dokumentach
Kroki aktualizacji i usuwania podpisów tekstowych w razie potrzeby
Najlepsze praktyki optymalizacji wydajności i zarządzania pamięcią

Zacznijmy od omówienia wymagań wstępnych.

Wymagania wstępne

Zanim zaczniesz, upewnij się, że Twoje środowisko programistyczne jest skonfigurowane i zawiera niezbędne narzędzia:

Wymagane biblioteki i zależności

GroupDocs.Signature dla .NET:Ta biblioteka umożliwia dodawanie funkcjonalności podpisu do aplikacji.
.NET Framework 4.6.1 lub nowszy (lub .NET Core 2.x+)

Wymagania dotyczące konfiguracji środowiska

Aby pobrać niezbędne pakiety, będziesz potrzebować środowiska programistycznego C#, takiego jak Visual Studio, i połączenia internetowego.

Wymagania wstępne dotyczące wiedzy

Zalecana jest znajomość podstawowych pojęć programowania w języku C#. Jeśli dopiero zaczynasz korzystać z GroupDocs.Signature dla .NET, nie martw się – ten przewodnik przeprowadzi Cię przez każdy krok.

Konfigurowanie GroupDocs.Signature dla platformy .NET

Aby rozpocząć, musisz zainstalować bibliotekę GroupDocs.Signature w swoim projekcie. Oto jak to zrobić:

Instalacja za pomocą interfejsu wiersza poleceń .NET

dotnet add package GroupDocs.Signature

Konsola Menedżera Pakietów

Install-Package GroupDocs.Signature

Interfejs użytkownika Menedżera pakietów NuGet

Otwórz projekt w programie Visual Studio.
Przejdź do Narzędzia > Menedżer pakietów NuGet > Zarządzaj pakietami NuGet dla rozwiązania.
Wyszukaj „GroupDocs.Signature” i zainstaluj najnowszą wersję.

Etapy uzyskania licencji

Bezpłatny okres próbny:Rozpocznij bezpłatny okres próbny, pobierając aplikację ze strony Bezpłatne wersje próbne GroupDocs.
Licencja tymczasowa:Uzyskaj tymczasową licencję, aby móc przetestować wszystkie funkcje na Licencja tymczasowa.
Zakup:Aby kontynuować korzystanie, należy zakupić licencję od Strona zakupu GroupDocs.

Podstawowa inicjalizacja i konfiguracja

Po instalacji zainicjuj GroupDocs.Signature w swoim projekcie w następujący sposób:

using GroupDocs.Signature;

// Zainicjuj instancję podpisu za pomocą ścieżki dokumentu.
Signature signature = new Signature("path/to/your/document.pdf");

Teraz, gdy wszystko jest już skonfigurowane, możemy przyjrzeć się sposobowi wykorzystania GroupDocs.Signature do różnych funkcjonalności.

Przewodnik wdrażania

Podpisz dokument podpisem tekstowym

Ta funkcja umożliwia dodawanie podpisów tekstowych do dokumentu. Omówmy to:

Przegląd

Możesz dostosować wygląd i pozycję swojego podpisu tekstowego, korzystając z różnych opcji, takich jak rozmiar czcionki, kolor, wyrównanie itp.

Wdrażanie krok po kroku

Krok 1: Określ ścieżkę do pliku i lokalizację wyjściową.

string filePath = "YOUR_DOCUMENT_DIRECTORY"; // Ścieżka do oryginalnego dokumentu
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedDocument.docx");

Krok 2:Utwórz podpis tekstowy za pomocą 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" }
    };

Krok 3:Podpisz dokument i wyświetl wyniki.

    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}");
    }
}

Kluczowe opcje konfiguracji

Wyrównanie pionowe i poziomeOkreśl, gdzie na stronie ma się pojawiać podpis.
Chrzcielnica:Dostosuj rozmiar i styl czcionki swojego podpisu tekstowego.

Zweryfikuj dokument pod kątem podpisu tekstowego

Weryfikacja zapewnia, że dokument został podpisany zgodnie z przeznaczeniem. Oto jak ją wdrożyć:

Przegląd

Zweryfikuj istniejące podpisy tekstowe w swoich dokumentach, aby potwierdzić ich autentyczność i integralność.

Wdrażanie krok po kroku

Krok 1:Określ ścieżkę dostępu do pliku podpisanego dokumentu.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Ścieżka do podpisanego dokumentu

Krok 2:Utwórz opcje weryfikacji za pomocą TextVerifyOptions.

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

Krok 3:Zweryfikuj dokument.

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

Wskazówki dotyczące rozwiązywania problemów

Upewnij się, że Text właściwość dokładnie odpowiada temu, co znajduje się w dokumencie.
Sprawdź to PageNumber odpowiada właściwej stronie zawierającej podpis.

Wyszukaj dokument pod kątem podpisu tekstowego

Dzięki tej funkcji możesz sprawnie lokalizować podpisy tekstowe w dokumentach.

Przegląd

Przeszukaj wszystkie lub wybrane strony dokumentu, aby znaleźć konkretne podpisy tekstowe.

Wdrażanie krok po kroku

Krok 1: Określ ścieżkę do pliku.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Ścieżka do podpisanego dokumentu

Krok 2: Używać TextSearchOptions do wyszukiwania.

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

Krok 3:Wykonaj wyszukiwanie.

    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}.");
        }
    }
}

Zaktualizuj podpis tekstowy dokumentu

W razie potrzeby modyfikuj istniejące podpisy tekstowe w dokumencie.

Przegląd

Dostosuj właściwości istniejących podpisów tekstowych, takie jak rozmiar i położenie.

Wdrażanie krok po kroku

Krok 1:Podaj ścieżkę dostępu do pliku i identyfikatory podpisu.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Ścieżka do podpisanego dokumentu
List<string> signatureIds = new List<string>(); // Załóżmy, że ta lista jest wypełniona prawidłowymi identyfikatorami podpisów

Krok 2: Tworzyć TextSignature obiekty do aktualizacji.

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
        };

Krok 3: Zaktualizuj dokument.

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

Kluczowe opcje konfiguracji

Szerokość i wysokość:Dostosuj rozmiar podpisu.
Wyrównanie poziome: Określ, w którym miejscu strony ma się wyświetlać zaktualizowany podpis.

Wniosek

Dzięki temu przewodnikowi nauczyłeś się, jak podpisywać, weryfikować, wyszukiwać, aktualizować i usuwać podpisy tekstowe w dokumentach za pomocą GroupDocs.Signature dla platformy .NET. Te możliwości są niezbędne do automatyzacji procesów podpisywania cyfrowego w aplikacjach. Aby uzyskać bardziej szczegółowe informacje i zapoznać się z opcjami zaawansowanymi, zapoznaj się z… oficjalna dokumentacja.