WorkbookBase.UnprotectDocument Yöntem

Makale
08/01/2011

Arayan Visual Studio Tools for Office çalışma zamanı modülü böylece parola koruması çalışma kitabından kaldırın ve kaydedilmesi önbelleğe alınan verileri etkinleştir.

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 UnprotectDocument

protected virtual void UnprotectDocument()

Açıklamalar

Bu yöntemde bir belge düzeyinde proje kitabınız parola kullanarak korunuyorsa ve zamanında değiştirilen önbelleğe alınan verileri içeren Excel için geçersiz kılar. Bu yöntemin kendi uygulamasında kullanmak Unprotect yöntemine geçici olarak korumasını çalışma kitabı.

Çalışma kitabını kaydettiğinizde varsayılan olarak, önbelleğe alınan verileri parola korumalı bir çalışma kitabında yapılan değişiklikler kalıcı olmaz. Önbelleğe alınmış veri değişiklikleri kaydetmek için projenizde aşağıdaki yöntemleri kılmalıdır:

UnprotectDocument. Çalışma kitabı kaydedildiğinde, Visual Studio Tools for Office çalışma zamanı modülü çağıran bu yöntemi. Geçici olarak çalışma kitabının korumasını kaldırır bu yöntemi kodu ekleyin. Bu, önbelleğe alınan verideki değişikliklerin kaydedilmesine olanak sağlar.
ProtectDocument. Çalışma kitabı kaydedildikten sonra Visual Studio Tools for Office çalışma zamanı modülü çağıran bu yöntemi. Çalışma kitabını koruma yeniden uygular bu yöntemi kodu ekleyin.

Daha fazla bilgi için bkz. Nasıl Yapılır: Parola Korumalı Belgeden Veriyi Önbelleğe Alma.

Örnekler

Aşağıdaki kod örneği, geçersiz kılmak gösterilmiştir UnprotectDocument geçici olarak önbelleğe alınan verileri değişiklikleri kaydedilebilir, çalışma kitabı korumasını Kaldır yöntemi. Örneğin ilk geçerli kaydeder ProtectStructure ve ProtectWindows değerleri aynı tür koruma daha sonra de uygulanabilir olduğunu ProtectDocument yöntemi. Çalıştır buradan bu kodu kullanmak için ThisWorkbook sınıfında bir belge düzeyinde proje için Excel. Kod adlı bir alanda depolanmış parola yok varsayar 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 Güvenliği

Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. kısmen güvenilir kod tarafından Kitaplıklar kullanma.