DocumentBase.UnprotectDocument أسلوب

مقالة
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 UnprotectDocument

protected virtual void UnprotectDocument()

ملاحظات

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

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

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

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

أمثلة

يلي تعليمات برمجية مثال يوضح كيفية يمنع UnprotectDocumentطريقة لإلغاء حماية مستند مؤقتاً حيث يمكن تم الحفظ التغييرات على بيانات المخزنة مؤقتاً. المثال أولاً بحفظ الحالي ProtectionTypeالقيمة، حيث يمكن إعادة تطبيق نفس النوع من حماية في وقت لاحق ProtectDocumentأسلوب. يفترض التعليمة البرمجية التي كلمة المرور هو تخزينها في حقل يسمى 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.

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