WorkbookBase.ProtectDocument أسلوب

مقالة
09/21/2010

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

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

بناء الجملة

'إقرار
Protected Overridable Sub ProtectDocument

protected virtual void ProtectDocument()

ملاحظات

يمنع th هو طريقة في مشروع المستوى المستندات ل Excel إذا كان مصنف الخاص بك هو محمية باستخدام كلمة مرور، ويحتوي على بيانات المخزنة مؤقتاً قد تتغير أثناء وقت التشغيل. في التطبيق الخاص بك لهذه الطريقة، استخدم 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الأسلوب. لاستخدام هذا تعليمات برمجية، قم بتشغيلها من ThisWorkbookالفئة في مشروع المستوى المستندات ل Excel. يفترض التعليمة البرمجية التي كلمة المرور هو تخزينها في حقل يسمى securelyStoredPassword.

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

Private protectStructureValue As Boolean
Private protectWindowsValue As Boolean

Protected Overrides Sub UnprotectDocument()
    protectStructureValue = Me.ProtectStructure
    protectWindowsValue = Me.ProtectWindows

    Me.Unprotect(securelyStoredPassword)
End Sub

Protected Overrides Sub ProtectDocument()
    Me.Protect(securelyStoredPassword, protectStructureValue, _
        protectWindowsValue)
End Sub

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

private bool protectStructureValue;
private bool protectWindowsValue;

protected override void UnprotectDocument()
{
    protectStructureValue = this.ProtectStructure;
    protectWindowsValue = this.ProtectWindows;

    this.Unprotect(securelyStoredPassword);
}

protected override void ProtectDocument()
{
    this.Protect(securelyStoredPassword, protectStructureValue,
        protectWindowsValue);
}

أمن NET Framework.

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