WorkbookBase.UnprotectDocument Methode

Definition

Wird von der Visual Studio-Tools für Office-Laufzeit abgerufen, damit Sie den Passwortschutz von der Arbeitsmappe entfernen und das Speichern von zwischengespeicherten Daten aktivieren können.

protected virtual void UnprotectDocument ();

Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die- UnprotectDocument Methode überschrieben wird, um den Schutz der Arbeitsmappe vorübergehend aufzuheben, damit Änderungen an den zwischengespeicherten Daten gespeichert werden können. Im Beispiel werden zuerst die aktuellen ProtectStructure - ProtectWindows Werte und-Werte gespeichert, sodass derselbe Schutztyp später in der-Methode erneut angewendet werden kann ProtectDocument . Wenn Sie diesen Code verwenden möchten, führen Sie ihn von der- ThisWorkbook Klasse in einem Projekt auf Dokument Ebene für Excel aus. Der Code geht davon aus, dass das Kennwort in einem Feld mit dem Namen gespeichert wird securelyStoredPassword .

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

Hinweise

Überschreiben Sie diese Methode in einem Projekt auf Dokument Ebene für Excel, wenn die Arbeitsmappe mit einem Kennwort geschützt ist und zwischengespeicherte Daten enthält, die möglicherweise zur Laufzeit geändert werden. Verwenden Sie in ihrer Implementierung dieser Methode die- Unprotect Methode, um den Schutz der Arbeitsmappe vorübergehend aufzuheben.

Standardmäßig werden Änderungen an zwischengespeicherten Daten in einer Kenn Wort geschützten Arbeitsmappe nicht beibehalten, wenn die Arbeitsmappe gespeichert wird. Wenn Sie Änderungen an den zwischengespeicherten Daten speichern möchten, müssen Sie die folgenden Methoden in Ihrem Projekt überschreiben:

  • UnprotectDocument Wenn die Arbeitsmappe gespeichert wird, Visual Studio-Tools für Office-Laufzeit ruft diese Methode auf. Fügen Sie dieser Methode Code hinzu, mit dem der Schutz der Arbeitsmappe vorübergehend verhindert wird. Dadurch können Änderungen an den zwischengespeicherten Daten gespeichert werden.

  • ProtectDocument Nachdem die Arbeitsmappe gespeichert wurde, Visual Studio-Tools für Office-Laufzeit ruft diese Methode auf. Fügen Sie dieser Methode Code hinzu, der den Schutz erneut auf die Arbeitsmappe anwendet.

Weitere Informationen finden Sie unter Gewusst wie: Zwischenspeichern von Daten in einem Kenn Wort geschützten Dokument.

Gilt für