Fődokumentum aláírása és ellenőrzése a GroupDocs.Signature for .NET segítségével

Hogyan sajátíthatja el a dokumentumaláírás és -ellenőrzés elsajátítását a GroupDocs.Signature for .NET segítségével?

A mai digitális környezetben a hatékony dokumentumaláírási megoldások kulcsfontosságúak a szerződések, megállapodások vagy bármilyen jogi dokumentáció kezeléséhez. A folyamat automatizálása időt takarít meg és csökkenti a hibákat. GroupDocs.Signature .NET-hez robusztus megoldást kínál a szöveges aláírások kezelésének egyszerűsítésére az alkalmazásaiban. Ez az átfogó útmutató végigvezeti Önt a GroupDocs.Signature for .NET funkcióin, beleértve a szöveges aláírások aláírását, ellenőrzését, keresését, frissítését és törlését.

Amit tanulni fogsz

Hogyan írhatunk alá dokumentumokat testreszabható szöveges aláírásokkal
Aláírt dokumentumok hatékony ellenőrzésének technikái
Módszerek meglévő szöveges aláírások keresésére dokumentumokban
Lépések a szöveges aláírások szükség szerinti frissítéséhez és törléséhez
A teljesítmény és a memóriakezelés optimalizálásának legjobb gyakorlatai

Kezdjük az előfeltételek áttekintésével.

Előfeltételek

Mielőtt elkezdené, győződjön meg arról, hogy a fejlesztői környezete rendelkezik a szükséges eszközökkel:

Szükséges könyvtárak és függőségek

GroupDocs.Signature .NET-hezEz a függvénykönyvtár lehetővé teszi aláírási funkciók hozzáadását az alkalmazásaihoz.
.NET-keretrendszer 4.6.1 vagy újabb verzió (vagy .NET Core 2.x+)

Környezeti beállítási követelmények

Szükséged lesz egy C# fejlesztői környezetre, például a Visual Studio-ra, és internetkapcsolatra a szükséges csomagok letöltéséhez.

Ismereti előfeltételek

Ajánlott az alapvető C# programozási fogalmak ismerete. Ha még csak most ismerkedik a GroupDocs.Signature for .NET-tel, ne aggódjon – ez az útmutató végigvezeti Önt minden lépésen.

A GroupDocs.Signature beállítása .NET-hez

A kezdéshez telepítenie kell a GroupDocs.Signature könyvtárat a projektjébe. Így teheti meg:

Telepítés .NET CLI-n keresztül

dotnet add package GroupDocs.Signature

Csomagkezelő konzol

Install-Package GroupDocs.Signature

NuGet csomagkezelő felhasználói felület

Nyisd meg a projektedet a Visual Studioban.
Navigálás ide: Eszközök > NuGet csomagkezelő > NuGet-csomagok kezelése megoldáshoz.
Keresd meg a „GroupDocs.Signature” fájlt, és telepítsd a legújabb verziót.

Licencbeszerzés lépései

Ingyenes próbaverzió: Kezdje egy ingyenes próbaverzióval a letöltéssel innen: GroupDocs ingyenes próbaverziók.
Ideiglenes engedély: Szerezzen be egy ideiglenes licencet a teljes funkciók kipróbálásához a következő címen: Ideiglenes engedély.
VásárlásA további használathoz vásároljon licencet a következő helyről: GroupDocs vásárlási oldal.

Alapvető inicializálás és beállítás

A telepítés után inicializálja a GroupDocs.Signature fájlt a projektben az alábbiak szerint:

using GroupDocs.Signature;

// Inicializálja az aláíráspéldányt a dokumentum elérési útjával.
Signature signature = new Signature("path/to/your/document.pdf");

Most, hogy minden készen áll, nézzük meg, hogyan használhatja ki a GroupDocs.Signature különböző funkcióit.

Megvalósítási útmutató

Dokumentum aláírása szöveges aláírással

Ez a funkció lehetővé teszi szöveges aláírások hozzáadását egy dokumentumhoz. Nézzük meg részletesebben:

Áttekintés

A szöveges aláírás megjelenését és pozícióját testreszabhatja különféle beállításokkal, például betűmérettel, színnel, igazítással stb.

Lépésről lépésre történő megvalósítás

1. lépés: Adja meg a fájl elérési útját és a kimeneti helyet.

string filePath = "YOUR_DOCUMENT_DIRECTORY"; // Az eredeti dokumentum elérési útja
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedDocument.docx");

2. lépés: Szöveges aláírás létrehozása a következővel: 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" }
    };

3. lépés: Aláírja a dokumentumot, és kiírja az eredményeket.

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

Kulcskonfigurációs beállítások

Függőleges igazítás és vízszintes igazításAz aláírás megjelenésének szabályozása az oldalon.
Betűtípus: Testreszabhatja a szöveges aláírás betűméretét és stílusát.

Dokumentum ellenőrzése szöveges aláírás szempontjából

Az ellenőrzés biztosítja, hogy a dokumentumot a tervek szerint írták alá. Így valósíthatja meg:

Áttekintés

Ellenőrizze a dokumentumokban található meglévő szöveges aláírásokat azok hitelességének és integritásának megerősítése érdekében.

Lépésről lépésre történő megvalósítás

1. lépés: Adja meg az aláírt dokumentum fájlelérési útját.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Az aláírt dokumentum elérési útja

2. lépés: Hozzon létre ellenőrzési lehetőségeket a következővel: TextVerifyOptions.

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

3. lépés: Ellenőrizze a dokumentumot.

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

Hibaelhárítási tippek

Biztosítsa a Text tulajdonság pontosan megegyezik a dokumentumban szereplő adatokkal.
Ellenőrizd, hogy PageNumber megfelel az aláírást tartalmazó megfelelő oldalnak.

Dokumentum keresése szöveges aláírás alapján

Ezzel a funkcióval hatékonyan megtalálhatja a szöveges aláírásokat a dokumentumokban.

Áttekintés

Keressen egy dokumentum összes vagy kiválasztott oldalain adott szöveges aláírások megkereséséhez.

Lépésről lépésre történő megvalósítás

1. lépés: Adja meg a fájl elérési útját.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Az aláírt dokumentum elérési útja

2. lépésHasználat TextSearchOptions a kereséshez.

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

3. lépés: Hajtsa végre a keresést.

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

Dokumentum szöveges aláírásának frissítése

Szükség esetén módosítsa a dokumentumban található meglévő szöveges aláírásokat.

Áttekintés

Módosítsa a meglévő szöveges aláírások tulajdonságait, például a méretet és a helyet.

Lépésről lépésre történő megvalósítás

1. lépés: Adja meg a fájl elérési útját és az aláírás-azonosítókat.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Az aláírt dokumentum elérési útja
List<string> signatureIds = new List<string>(); // Tegyük fel, hogy ez a lista érvényes aláírás-azonosítókkal van feltöltve.

2. lépésLétrehozás TextSignature objektumok frissítésekhez.

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

3. lépés: Frissítse a dokumentumot.

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

Kulcskonfigurációs beállítások

Szélesség és magasság: Az aláírás méretének beállítása.
Vízszintes igazítás: Azt szabályozza, hogy a frissített aláírás hol jelenjen meg az oldalon.

Következtetés

Az útmutató követésével megtanulta, hogyan írhat alá, ellenőrizhet, kereshet, frissíthet és törölhet szöveges aláírásokat dokumentumokban a GroupDocs.Signature for .NET segítségével. Ezek a képességek elengedhetetlenek a digitális aláírási folyamatok automatizálásához az alkalmazásaiban. Részletesebb információkért és a speciális beállításokért lásd a következőt: hivatalos dokumentáció.