WorkbookBase.UnprotectDocument Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.