Metoda DocumentBase.UnprotectDocument —

Artykuł
05/08/2013

Zapewnia możliwość usunąć ochronę hasłem z dokumentu i włączyć mają być zapisywane dane buforowany.

Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestaw: Microsoft.Office.Tools.Word.v4.0.Utilities (w Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Składnia

'Deklaracja
Protected Overridable Sub UnprotectDocument

protected virtual void UnprotectDocument()

Uwagi

Zastąpić tę metoda w projekcie na poziomie dokumentu dla programu Word, jeśli Twój dokument jest chroniony przy użyciu hasła i zawiera buforowane dane, które mogą być zmieniane w czasie wykonywania.W celu stosowania tej metody należy użyć Unprotect metodę, aby tymczasowo wyłączyć ochronę dokumentu.

Domyślnie zmiany buforowanych danych w dokumencie chronionych hasłem nie są zachowywane po zapisaniu dokumentu.Aby zapisać zmiany, aby buforowane dane, należy zastąpić następujące metody w projekcie:

UnprotectDocument.Gdy dokument zostanie zapisany, Visual Studio 2010 Tools for Office Runtime wywołuje tę metodę.Dodaj kod do tej metody, która tymczasowo wyłączy ochronę dokumentu.Dzięki temu zmiany mają być zapisywane dane buforowany.
ProtectDocument.Po zapisaniu dokumentu, Visual Studio 2010 Tools for Office Runtime wywołuje tę metodę.Dodaj kod do tej metody, która ponownie stosuje ochrony w dokumencie.

Aby uzyskać więcej informacji, zobacz Jak: pamięć podręczna danych w dokumencie chroniony hasłem.

Przykłady

Poniższy przykład kodu demonstruje, jak zastąpić UnprotectDocument metoda, aby tymczasowo wyłączanie ochrony dokumentu, tak aby można zapisać zmian buforowane dane.Przykład najpierw zapisuje bieżący ProtectionType wartość, tak aby można było później w przywracane tego samego rodzaju ochrony ProtectDocument metoda.Kod zakłada, że hasło jest przechowywane w polu o nazwie securelyStoredPassword.Aby wykorzystać ten przykład, należy uruchomić go z ThisDocument klasy w projekcie na poziomie dokumentu.

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

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..