SignatureLineOptions

SignatureLineOptions class

يسمح بتحديد خيارات لإدراج سطر التوقيع. يُستخدم فيDocumentBuilder .

لمعرفة المزيد، قم بزيارةالعمل مع التوقيعات الرقمية مقالة توثيقية.

public class SignatureLineOptions

المنشئون

اسموصف
SignatureLineOptions()Default_Constructor

الخصائص

اسموصف
AllowComments { get; set; }يحصل على قيمة أو يعينها تشير إلى أن المُوقِّع يمكنه إضافة تعليقات في مربع حوار التوقيع. القيمة الافتراضية لهذه الخاصية هيخطأ شنيع .
DefaultInstructions { get; set; }يحصل على قيمة أو يعينها تشير إلى أن التعليمات الافتراضية تظهر في مربع الحوار “التوقيع”. القيمة الافتراضية لهذه الخاصية هيحقيقي .
Email { get; set; }يحصل على عنوان البريد الإلكتروني للموقع المقترح أو يعينه. القيمة الافتراضية لهذه الخاصية هيسلسلة فارغة (Empty ).
Instructions { get; set; }يحصل على التعليمات أو يعينها للموقع والتي يتم عرضها عند توقيع سطر التوقيع. القيمة الافتراضية لهذه الخاصية هيسلسلة فارغة (Empty ).
ShowDate { get; set; }يحصل على قيمة أو يعينها تشير إلى أن تاريخ التوقيع يظهر في سطر التوقيع. القيمة الافتراضية لهذه الخاصية هيحقيقي .
Signer { get; set; }يحصل على أو يعين الموقع المقترح لسطر التوقيع. القيمة الافتراضية لهذه الخاصية هيسلسلة فارغة (Empty ).
SignerTitle { get; set; }يحصل على عنوان المُوقِّع المُقترح أو يُعيِّنه. القيمة الافتراضية لهذه الخاصية هيسلسلة فارغة (Empty ).

أمثلة

يوضح كيفية توقيع مستند باستخدام شهادة شخصية وسطر التوقيع.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

SignatureLineOptions signatureLineOptions = new SignatureLineOptions
{
    Signer = "vderyushev",
    SignerTitle = "QA",
    Email = "vderyushev@aspose.com",
    ShowDate = true,
    DefaultInstructions = false,
    Instructions = "Please sign here.",
    AllowComments = true
};

SignatureLine signatureLine = builder.InsertSignatureLine(signatureLineOptions).SignatureLine;
signatureLine.ProviderId = Guid.Parse("CF5A7BB4-8F3C-4756-9DF6-BEF7F13259A2");

Assert.False(signatureLine.IsSigned);
Assert.False(signatureLine.IsValid);

doc.Save(ArtifactsDir + "DocumentBuilder.SignatureLineProviderId.docx");

SignOptions signOptions = new SignOptions
{
    SignatureLineId = signatureLine.Id,
    ProviderId = signatureLine.ProviderId,
    Comments = "Document was signed by vderyushev",
    SignTime = DateTime.Now
};

CertificateHolder certHolder = CertificateHolder.Create(MyDir + "morzal.pfx", "aw");

DigitalSignatureUtil.Sign(ArtifactsDir + "DocumentBuilder.SignatureLineProviderId.docx", 
    ArtifactsDir + "DocumentBuilder.SignatureLineProviderId.Signed.docx", certHolder, signOptions);

// أعد فتح المستند المحفوظ لدينا، وتأكد من أن الخاصيتين "IsSigned" و"IsValid" تساويان "true"،
// يشير إلى أن سطر التوقيع يحتوي على توقيع.
doc = new Document(ArtifactsDir + "DocumentBuilder.SignatureLineProviderId.Signed.docx");
Shape shape = (Shape)doc.GetChild(NodeType.Shape, 0, true);
signatureLine = shape.SignatureLine;

Assert.True(signatureLine.IsSigned);
Assert.True(signatureLine.IsValid);

أنظر أيضا

Shading Class SpecialChar Class