WorkbookBase.ProtectDocument Yöntem

Makale
10/29/2012

Arayan Office için Visual Studio Araçları çalışma zamanı modülü , önbelleğe alınan veriler kaydedildikten sonra çalışma kitabına parola koruması yeniden uygulayabilirsiniz.

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

Sözdizimi

'Bildirim
Protected Overridable Sub ProtectDocument

protected virtual void ProtectDocument()

Notlar

Bu yöntem bir belge düzeyi projesinde çalışma kitabına bir parola kullanarak korumalı çalışma zamanında değiştirilen önbelleğe alınmış veri içeriyorsa, Excel için geçersiz kılar.Bu yöntemin kendi uygulamalarınızda kullanmak Protect çalışma kitabını korumak için yöntem.

Çalışma kitabını kaydettiğinizde varsayılan olarak, parola korumalı bir çalışma kitabında önbelleğe alınan verideki 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.Çalışma kitabı kaydedildiğinde, Office için Visual Studio Araçları çalışma zamanı modülü bu yöntemi çağırır.Geçici olarak çalışma kitabının 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.Çalışma kitabı kaydedildikten sonra Office için Visual Studio Araçları çalışma zamanı modülü bu yöntemi çağırır.Çalışma kitabına korumayı yeniden uygular bu yöntem için kod ekleyin.

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

Office için Visual Studio Araçları çalışma zamanı modülü Çağrıları ProtectDocument yöntemi bile önbelleğe alınmış veri için parola koruması ilgisiz bazı hata nedeniyle kaydedilemedi.Örneğin, uygulamanız ICachedType nasıl önbelleğe alınmış verileri özelleştirmek için arabirim belgede saklanan ProtectDocument yöntemi çağrıldığında bile sizin ICachedType uygulama önbelleğe alınmış verilerin kaydedilmesini engelleyen bir istisna atar.

Örnekler

Aşağıdaki kod örneğinde nasıl geçersiz kılınacağı gösterilmektedir ProtectDocument yöntemi geçersiz kılarak kaldırıldı korumayı yeniden uygulamanız için UnprotectDocument yöntem.Bu kodu kullanmak için çalıştırın ThisWorkbook sınıf Excel için belge düzeyi projesi içinde.Kod parolayı isimli alanda saklandığı varsayılır 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);
}