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

أنظر أيضا

ViewType Enum ZoomType Enum