DocumentBase.ProtectDocument أسلوب

مقالة
09/21/2010

يوفر لك فرصة لإعادة تطبيق كلمة المرور حماية إلى مستند بعد تم الحفظ بيانات المخزنة مؤقتاً.

مساحة الاسم: Microsoft.Office.Tools.Word
التجميع: Microsoft.Office.Tools.Word.v4.0.Utilities (في Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

بناء الجملة

'إقرار
Protected Overridable Sub ProtectDocument

protected virtual void ProtectDocument()

ملاحظات

يمنع th هو طريقة في مشروع المستوى مستندات الخاصة ب الكلمة إذا كان مستند الخاص بك هو محمية باستخدام كلمة مرور، ويحتوي على البيانات المخزنة مؤقتاً قد تتغير أثناء وقت التشغيل. في التطبيق الخاص بك لهذه الطريقة، استخدم Protectأسلوب إلى حماية مستند.

افتراضياً، التغييرات التي تمت على بيانات المخزنة في مستند محمي بكلمة مرور غير persهوted عند المستند هو المحفوظة. لحفظ التغييرات إلى بيانات المخزنة مؤقتاً، يجب يمنع الأساليب التالية في مشروع الخاص بك:

UnprotectDocument. عند مستند هو تم الحفظ Visual Studio Tools لوقت تشغيل Officeيستدعي th هو الأسلوب. إضافة تعليمات برمجية إلى هذا الأسلوب unprotects مستند بشكل مؤقت. وهذا يمكّن التغييرات لتكون محفوظة في البيانات المخزنة مؤقتاً.
ProtectDocument. بعد مستند هو تم الحفظ Visual Studio Tools لوقت تشغيل Officeيستدعي th هو الأسلوب. إضافة تعليمات برمجية إلى هذا الأسلوب إعادة تطبيق الحماية للمستند.

لمزيد من المعلومات، راجع كيفية: بيانات ذاكرة التخزين المؤقت في مستند المحمي كلمة مرور.

Visual Studio Tools لوقت تشغيل Officeالمكالمات ProtectDocumentالأسلوب حتى إذا تعذر تم الحفظ بيانات المخزنة مؤقتاً بسبب بعض الأخطاء التي هو التي لا للحماية بكلمة مرور. على سبيل المثال، إذا قمت بتطبيق ICachedTypeواجهة ليخصص بيانات المخزنة مؤقتاً بكيفية هو المخزنة في هذا مستند، ProtectDocumentأسلوب هو لو حتى تسمى الخاص بك ICachedTypeيطرح تطبيق استثناء تمنع تم الحفظ بيانات المخزنة مؤقتاً.

أمثلة

ما يلي تعليمات برمجية مثال يوضح كيفية يمنع ProtectDocumentالأسلوب لإعادة تطبيق حماية الذي تمت إزالته بيمنع UnprotectDocumentالأسلوب. يفترض التعليمة البرمجية التي كلمة المرور هو تخزينها في حقل يسمى securelyStoredPassword. إلى لاستخدام هذا المثال، قم بتشغيلها من ThisDocumentالفئة في مشروع المستوى مستند.

<CachedAttribute()> _
Public CachedString As String = "This string is cached in the document."

Private protectionTypeValue As Word.WdProtectionType

Protected Overrides Sub UnprotectDocument()
    If Me.ProtectionType <> Word.WdProtectionType.wdNoProtection Then
        protectionTypeValue = Me.ProtectionType
        Me.Unprotect(securelyStoredPassword)
    End If
End Sub

Protected Overrides Sub ProtectDocument()
    Me.Protect(protectionTypeValue, Password:=securelyStoredPassword)
End Sub

[CachedAttribute]
public string CachedString = "This string is cached in the document.";

private Word.WdProtectionType protectionTypeValue;

protected override void UnprotectDocument()
{
    if (this.ProtectionType != Word.WdProtectionType.wdNoProtection)
    {
        protectionTypeValue = this.ProtectionType;
        this.Unprotect(ref securelyStoredPassword);
    }
}

protected override void ProtectDocument()
{
    this.Protect(protectionTypeValue, ref missing,
        ref securelyStoredPassword, ref missing, ref missing);
}

أمن NET Framework.

الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.