WriteProtection

WriteProtection class

يحدد إعدادات الحماية ضد الكتابة لمستند.

public class WriteProtection

الخصائص

اسم وصف
IsWriteProtected { get; } إرجاع صحيح عند تعيين كلمة مرور للحماية ضد الكتابة.
ReadOnlyRecommended { get; set; } يحدد ما إذا كان مؤلف المستند قد أوصى بفتح المستند للقراءة فقط.

طُرق

اسم وصف
SetPassword(string) تعيين كلمة مرور الحماية ضد الكتابة للمستند.
ValidatePassword(string) إرجاع صحيح إذا كانت كلمة المرور المحددة هي نفسها كلمة مرور الحماية ضد الكتابة التي تم حماية المستند بها.

ملاحظات

تحدد الحماية ضد الكتابة ما إذا كان المؤلف قد أوصى بفتح المستند للقراءة فقط و / أو يتطلب كلمة مرور لتعديل المستند.

تختلف الحماية ضد الكتابة عن حماية المستندات. تم تحديد الحماية ضد الكتابة في Microsoft Word في خيارات مربع الحوار “حفظ باسم”.

لا تقوم بإنشاء نسخ من هذه الفئة مباشرة. يمكنك الوصول إلى إعدادات حماية المستندات عبر ملفWriteProtection منشأه.

أمثلة

يوضح كيفية حماية مستند بكلمة مرور.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Hello world! This document is protected.");

// أدخل كلمة مرور يصل طولها إلى 15 حرفًا ، ثم تحقق من حالة حماية المستند.
doc.WriteProtection.SetPassword("MyPassword");
doc.WriteProtection.ReadOnlyRecommended = true;

Assert.IsTrue(doc.WriteProtection.IsWriteProtected);
Assert.IsTrue(doc.WriteProtection.ValidatePassword("MyPassword"));

// لا تمنع الحماية تحرير المستند برمجيًا ولا تقوم بتشفير المحتويات.
doc.Save(ArtifactsDir + "Document.WriteProtection.docx");
doc = new Document(ArtifactsDir + "Document.WriteProtection.docx");

Assert.IsTrue(doc.WriteProtection.IsWriteProtected);

builder = new DocumentBuilder(doc);
builder.MoveToDocumentEnd();
builder.Writeln("Writing text in a protected document.");

Assert.AreEqual("Hello world! This document is protected." +
                "\rWriting text in a protected document.", doc.GetText().Trim());

أنظر أيضا