DocumentBase.UnprotectDocument Yöntem

Makale
10/29/2012

Size parola korumasını kaldırmak ve kaydedilmesi önbelleğe alınan verileri etkinleştirmek için bir fırsat sağlar.

Ad alanı: Microsoft.Office.Tools.Word
Derleme: Microsoft.Office.Tools.Word.v4.0.Utilities (Microsoft.Office.Tools.Word.v4.0.Utilities.dll içinde)

Sözdizimi

'Bildirim
Protected Overridable Sub UnprotectDocument

protected virtual void UnprotectDocument()

Notlar

Bu yöntem bir belge düzeyi projesinde parola kullanarak belgenin korumalı çalışma zamanında değiştirilen önbelleğe alınmış veri içeriyorsa, Word için geçersiz kılar.Bu yöntemin kendi uygulamalarınızda kullanmak Unprotect geçici olarak belge korumasını kaldırmak için yöntem.

Belge kaydedildiğinde varsayılan olarak, parola korumalı belgede önbelleğe alınmış veriye yapılan değişiklikler kalıcı olmaz.Önbelleğe alınmış verideki değişiklikleri kaydetmek için projenizde aşağıdaki yöntemleri geçersiz kılmanız gerekir:

UnprotectDocument.Belge kaydedildiğinde, Office için Visual Studio Araçları çalışma zamanı modülü bu yöntemi çağırır.Geçici olarak belge korumasını kaldırır bu yöntem için kod ekleyin.Bu, önbelleğe alınan verideki değişikliklerin kaydedilmesine olanak sağlar.
ProtectDocument.Belge kaydedildikten sonra Office için Visual Studio Araçları çalışma zamanı modülü bu yöntemi çağırır.Kod belgeye korumayı yeniden uygular bu yöntem ekleyin.

Daha fazla bilgi için bkz. Nasıl yapılır: parola ile korunan bir belgede önbelleği verisi.

Örnekler

Aşağıdaki kod örneğinde nasıl geçersiz kılınacağı gösterilmektedir UnprotectDocument geçici olarak önbelleğe alınan verideki değişiklikler kaydedildiğinde, belgeyi korumasız yapmanız için yöntem.Geçerli örnek ilk kaydeder ProtectionType değeri, daha sonra aynı tür korumanın uygulanabilir olduğunu ProtectDocument yöntem.Kod parolayı isimli alanda saklandığı varsayılır securelyStoredPassword.Bu örneği kullanmak için çalıştırın ThisDocument bir belge düzeyi projesinde sınıf.

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