Freigeben über


DocumentBase.Unprotect-Methode

Hebt den Schutz für das Dokument auf.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntax

'Declaration
Public Sub Unprotect ( _
    ByRef password As Object _
)
public void Unprotect(
    ref Object password
)

Parameter

  • password
    Typ: System.Object%
    Das Kennwort, das zum Schützen des Dokuments verwendet wird.Bei Kennwörtern muss die Groß-/Kleinschreibung beachtet werden.Wenn das Dokument mit einem Kennwort geschützt ist und das korrekte Kennwort nicht angegeben wird, wird der Benutzer in einem Dialogfeld zur Eingabe des Kennworts aufgefordert.

Hinweise

Verwenden Sie in Anwendungen keine hartcodierten Kennwörter. Wenn in einer Prozedur ein Kennwort erforderlich ist, fordern Sie es vom Benutzer an, speichern Sie es in einer Variablen, und verwenden Sie anschließend die Variable im Code.

Wenn das Dokument nicht geschützt ist, wird eine Ausnahme ausgelöst.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird mithilfe der Unprotect-Methode der Dokumentschutz aufgehoben. Im Beispiel wird davon ausgegangen, dass die Kennwortvariable securelyStoredPassword durch eine Benutzereingabe festgelegt wurde. Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse in einem Projekt auf Dokumentebene aus.

Private Sub DocumentUnprotect(ByRef securelyStoredPassword As Object)
    If Me.ProtectionType <> Word.WdProtectionType.wdNoProtection Then
        Me.Unprotect(securelyStoredPassword)
    End If
End Sub
private void DocumentUnprotect(ref object securelyStoredPassword)
{
    if (this.ProtectionType != Word.WdProtectionType.wdNoProtection)
    {
        this.Unprotect(ref securelyStoredPassword);
    }
}

.NET Framework-Sicherheit

Siehe auch

Referenz

DocumentBase Klasse

Microsoft.Office.Tools.Word-Namespace