.NET için GroupDocs.Signature’da Uzmanlaşma: Belge Bilgilerini Verimli Şekilde Ayıklama ve Görüntüleme

giriiş

Uygulamalarınızdaki belgelerden kapsamlı ayrıntıları verimli bir şekilde çıkarmak mı istiyorsunuz? İster sözleşmeleri, ister anlaşmaları veya çok sayfalı PDF’leri yönetiyor olun, sağlam bir çözüm olmazsa olmazdır. .NET için GroupDocs.Signature Form alanları, imzalar, meta veriler ve daha fazlası gibi öğeleri alıp görüntüleyerek belge analizini kolaylaştırmak için tasarlanmış güçlü özellikler sunar. Bu eğitim, uygulamanızın işlevselliğini artırmak için bu özellikleri nasıl kullanacağınız konusunda size rehberlik edecektir.

Öğrenecekleriniz:

  • GroupDocs.Signature for .NET kullanılarak ayrıntılı belge bilgileri nasıl alınır?
  • Çeşitli imza türlerini ve form alanı ayrıntılarını görüntüleme
  • Meta verileri ve sayfaya özgü nitelikleri çıkarma

Uygulamaya geçmeden önce ön koşulları gözden geçirelim.

Ön koşullar

GroupDocs.Signature for .NET’i kullanmadan önce, ortamınızın doğru şekilde kurulduğundan emin olun. Bu eğitim, C# bilgisine ve belge işleme kavramlarına ilişkin temel bilgilere sahip olduğunuzu varsayar.

Gerekli Kitaplıklar ve Bağımlılıklar

  • .NET için GroupDocs.Signature: Kullanacağımız birincil kütüphane.
  • .NET Framework veya .NET Core: Proje kurulumunuza bağlı olarak.

Ortam Kurulumu

Visual Studio veya .NET projelerini destekleyen başka bir uygun IDE ile hazır bir geliştirme ortamınız olduğundan emin olun.

Bilgi Ön Koşulları

  • C# programlamanın temel bilgisi.
  • Belge türleri (PDF, Word, Excel) ve özellikleri hakkında bilgi sahibi olunması.

.NET için GroupDocs.Signature Kurulumu

GroupDocs.Signature for .NET’i kullanmak için kitaplığı yüklemeniz gerekir. İşte birkaç yöntem:

Kurulum Talimatları

.NET CLI’yi kullanarak:

dotnet add package GroupDocs.Signature

Paket Yöneticisi Konsolunu Kullanma:

Install-Package GroupDocs.Signature

NuGet Paket Yöneticisi Kullanıcı Arayüzü: NuGet Paket Yöneticisi’nde “GroupDocs.Signature” ifadesini arayın ve en son sürümü yükleyin.

Lisans Edinimi

GroupDocs.Signature’dan tam olarak yararlanmak için bir lisans edinmeyi düşünün:

  • Ücretsiz Deneme: Özellikleri keşfetmek için ücretsiz denemeyle başlayın.
  • Geçici Lisans:Uzun süreli testler için geçici lisans alın.
  • Satın almak: Üretim amaçlı tam lisans satın alın.

Kurulum ve lisanslama tamamlandıktan sonra, aşağıda gösterildiği gibi GroupDocs.Signature ortamını ayarlayarak projenizi başlatın:

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

public class GetDocumentInfoFeature
{
    public static void Run()
    {
        // Analiz etmek istediğiniz belgenin dosya yolunu tanımlayın
        string filePath = "YOUR_DOCUMENT_DIRECTORY\Sample_Signed_Multi_Document.pdf";  // Gerçek belge yolunuzla değiştirin
        
        SignatureSettings signatureSettings = new SignatureSettings
        {
            IncludeStandardMetadataSignatures = true
        };

        using (Signature signature = new Signature(filePath, signatureSettings))
        {
            IDocumentInfo documentInfo = signature.GetDocumentInfo();
            // Daha sonraki işlemler burada gerçekleştirilecektir...
        }
    }
}

Uygulama Kılavuzu

Kurulum tamamlandıktan sonra, .NET için GroupDocs.Signature’ın çeşitli özelliklerinin nasıl uygulanacağını inceleyelim.

Temel Belge Özelliklerini Alma ve Görüntüleme

Genel Bakış: Dosya biçimi, boyutu ve sayfa sayısı gibi temel özellikleri çıkarın.

Adım Adım Uygulama:

  1. İmza Nesnesini Başlat: Bir örnek oluşturun Signature belgenizin yolunu içeren sınıf.
  2. GetDocumentInfo Yöntemi: Kullanın GetDocumentInfo() Belge hakkında ayrıntılı bilgi alma yöntemi.
  3. Belge Özelliklerini Görüntüle: Biçim, uzantı ve boyut gibi temel özellikleri kullanarak çıktı alın Console.WriteLine hata ayıklama veya günlükleme amaçları için.
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}");

Her Belge Sayfası Hakkında Bilgi Görüntüle

Genel Bakış: Belgedeki her sayfayla ilgili bilgileri alıp görüntüleyerek daha derinlemesine bilgi edinin.

Adım Adım Uygulama:

  1. Sayfalar Arasında Gezin: Döngü yoluyla documentInfo.Pages Genişlik ve yükseklik gibi bireysel sayfa ayrıntılarına erişmek için.
foreach (PageInfo pageInfo in documentInfo.Pages)
{
    Console.WriteLine($" - page-{pageInfo.PageNumber} Width {pageInfo.Width}, Height {pageInfo.Height}");
}

Form Alanı İmza Bilgilerini Görüntüle

Genel Bakış: Belge içindeki form alanlarıyla ilgili bilgileri ayıklayın ve görüntüleyin.

Adım Adım Uygulama:

  1. Erişim Formu Alanları: Kullanmak documentInfo.FormFields belgede bulunan tüm form alanı imzalarını almak için.
  2. Her Form Alanının Ayrıntılarını Görüntüle: Her form alanı üzerinde yineleme yapın ve türünü, adını ve değerini çıktı olarak verin.
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}");
}

Çeşitli İmza Bilgilerini Görüntüle

Genel Bakış: Metin, resim, dijital, barkod, QR kodu, form alanı ve meta veri imzaları için bilgileri alın ve görüntüleyin.

Uygulama Adımları:

  • Metin İmzaları: Erişim documentInfo.TextSignatures Her metin imzası hakkında kimlik bilgisi, konum, boyut ve oluşturulma tarihleri dahil olmak üzere ayrıntıları almak için.
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()}");
}
  • Görüntü İmzaları: Metin imzalarına benzer şekilde, şunu kullanın: documentInfo.ImageSignatures Resim imzalarının boyutu ve biçimi gibi ayrıntılar için.
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()}");
}
  • Dijital İmzalar: Dijital imzalar için şunu kullanın: documentInfo.DigitalSignatures İmza kimliklerini ve zaman damgalarını çıkarmak için.
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()}");
}
  • Barkod ve QR Kod İmzaları: Kullanmak documentInfo.BarcodeSignatures Ve documentInfo.QrCodeSignatures barkod ve QR kod ayrıntılarını toplamak için.
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}");
}

Çözüm

Bu eğitimi takip ederek, kapsamlı belge bilgilerini verimli bir şekilde çıkarmak ve görüntülemek için GroupDocs.Signature for .NET’i nasıl kullanacağınızı öğrendiniz. Bu beceri seti, uygulamanızın belgeleri hassas ve kolay bir şekilde yönetme becerisini artıracaktır.

Sonraki Adımlar:

  • GroupDocs.Signature’ın ek özelliklerini keşfedin.
  • Uygulamalarınızda imza doğrulamasını uygulayın.
  • Bu işlevselliği, otomatik belge işleme için daha büyük iş akışlarına entegre edin.