A GroupDocs.Signature for .NET elsajátítása: Dokumentuminformációk hatékony kinyerése és megjelenítése

Bevezetés

Szeretné hatékonyan kinyerni az alkalmazásaiban található dokumentumok átfogó részleteit? Akár szerződések, megállapodások vagy többoldalas PDF-ek kezeléséről van szó, egy robusztus megoldás elengedhetetlen. GroupDocs.Signature .NET-hez hatékony funkciókat kínál, amelyek célja a dokumentumelemzés egyszerűsítése olyan elemek lekérésével és megjelenítésével, mint az űrlapmezők, aláírások, metaadatok és egyebek. Ez az oktatóanyag végigvezeti Önt ezen képességek kihasználásán az alkalmazás funkcionalitásának javítása érdekében.

Amit tanulni fogsz:

Hogyan kérhetünk le részletes dokumentuminformációkat a GroupDocs.Signature for .NET használatával?
Különböző aláírástípusok és űrlapmező-részletek megjelenítése
Metaadatok és oldalspecifikus attribútumok kinyerése

Mielőtt belevágnánk a megvalósításba, tekintsük át az előfeltételeket.

Előfeltételek

A GroupDocs.Signature for .NET használata előtt győződjön meg arról, hogy a környezete megfelelően van beállítva. Ez az oktatóanyag feltételezi a C# ismeretét és a dokumentumfeldolgozási koncepciók alapvető ismeretét.

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

GroupDocs.Signature .NET-hez: Az elsődleges könyvtár, amelyet használni fogunk.
.NET-keretrendszer vagy .NET CoreA projekt beállításaitól függően.

Környezet beállítása

Győződjön meg arról, hogy rendelkezik egy fejlesztői környezettel, amely Visual Studio vagy más megfelelő IDE segítségével támogatja a .NET projekteket.

Ismereti előfeltételek

C# programozás alapjainak ismerete.
Ismerkedés a dokumentumtípusokkal (PDF, Word, Excel) és azok tulajdonságaival.

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

A GroupDocs.Signature for .NET használatához telepítenie kell a könyvtárat. Íme néhány módszer:

Telepítési utasítások

.NET parancssori felület használata:

dotnet add package GroupDocs.Signature

A csomagkezelő konzol használata:

Install-Package GroupDocs.Signature

NuGet csomagkezelő felhasználói felület: Keresse meg a „GroupDocs.Signature” kifejezést a NuGet csomagkezelőben, és telepítse a legújabb verziót.

Licencszerzés

A GroupDocs.Signature teljes kihasználásához érdemes lehet licencet beszerezni:

Ingyenes próbaverzió: Kezdje egy ingyenes próbaverzióval a funkciók felfedezését.
Ideiglenes engedély: Szerezzen be ideiglenes engedélyt meghosszabbított tesztelésre.
Vásárlás: Vásároljon teljes licencet éles használatra.

A telepítés és a licencelés után inicializálja a projektet a GroupDocs.Signature környezet beállításával az alábbiak szerint:

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

public class GetDocumentInfoFeature
{
    public static void Run()
    {
        // Adja meg az elemezni kívánt dokumentum fájlelérési útját
        string filePath = "YOUR_DOCUMENT_DIRECTORY\Sample_Signed_Multi_Document.pdf";  // Cserélje le a tényleges dokumentumútvonalra
        
        SignatureSettings signatureSettings = new SignatureSettings
        {
            IncludeStandardMetadataSignatures = true
        };

        using (Signature signature = new Signature(filePath, signatureSettings))
        {
            IDocumentInfo documentInfo = signature.GetDocumentInfo();
            // további műveletek itt kerülnek végrehajtásra...
        }
    }
}

Megvalósítási útmutató

A beállítás befejezése után vizsgáljuk meg, hogyan valósíthatók meg a GroupDocs.Signature for .NET különböző funkciói.

Alapvető dokumentumtulajdonságok lekérése és megjelenítése

Áttekintés: Kinyerheti az alapvető tulajdonságokat, például a fájlformátumot, a méretet és az oldalszámot.

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

Aláírásobjektum inicializálása: Hozz létre egy példányt a következőből: Signature osztály a dokumentum elérési útjával.
GetDocumentInfo metódus: Használja a GetDocumentInfo() módszer a dokumentum részletes információinak lekérésére.
Dokumentumtulajdonságok megjelenítése: Alapvető tulajdonságok, például formátum, kiterjesztés és méret kimenete a következő használatával: Console.WriteLine hibakeresési vagy naplózási célokra.

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

Információk megjelenítése az egyes dokumentumoldalakról

ÁttekintésMerüljön el mélyebben a dokumentumban található oldalakkal kapcsolatos információk lekérésével és megjelenítésével.

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

Oldalak ismétlése: Hurok végigjátszása documentInfo.Pages az egyes oldaladatok, például a szélesség és a magasság eléréséhez.

foreach (PageInfo pageInfo in documentInfo.Pages)
{
    Console.WriteLine($" - page-{pageInfo.PageNumber} Width {pageInfo.Width}, Height {pageInfo.Height}");
}

Űrlapmező aláírásainak információinak megjelenítése

Áttekintés: Űrlapmezőkhöz kapcsolódó információk kinyerése és megjelenítése a dokumentumon belül.

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

Hozzáférési űrlap mezőiHasználat documentInfo.FormFields a dokumentumban található összes űrlapmező-aláírás lekéréséhez.
Az egyes űrlapmezők részleteinek megjelenítése: Menjen végig minden űrlapmezőn, és adja ki a típusát, nevét és értékét.

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

Különböző aláírási információk megjelenítése

Áttekintés: Szöveges, képi, digitális, vonalkódos, QR-kódos, űrlapmezős és metaadat-aláírások információinak lekérése és megjelenítése.

Megvalósítási lépések:

Szöveges aláírásokHozzáférés documentInfo.TextSignatures hogy részleteket kapjon az egyes szöveges aláírásokról, beleértve az azonosítójukat, helyüket, méretüket és létrehozási dátumukat.

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

KépaláírásokA szöveges aláírásokhoz hasonlóan használja documentInfo.ImageSignatures olyan részletekért, mint a képaláírások mérete és formátuma.

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

Digitális aláírásokDigitális aláírásokhoz használja a következőt: documentInfo.DigitalSignatures aláírás-azonosítók és időbélyegek kinyeréséhez.

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

Vonalkód- és QR-kód-aláírásokHasználat documentInfo.BarcodeSignatures és documentInfo.QrCodeSignatures a vonalkód és a QR-kód adatainak gyűjtéséhez.

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

Következtetés

Ezzel az oktatóanyaggal megtanultad, hogyan használhatod a GroupDocs.Signature for .NET-et a dokumentuminformációk hatékony kinyerésére és megjelenítésére. Ez a készségfejlesztés javítja az alkalmazásod azon képességét, hogy pontosan és egyszerűen kezelje a dokumentumokat.

Következő lépések:

Fedezze fel a GroupDocs.Signature további funkcióit.
Implementáljon aláírás-érvényesítést az alkalmazásaiban.
Integrálja ezt a funkciót nagyobb munkafolyamatokba az automatizált dokumentumfeldolgozás érdekében.