Freigeben über


DocumentBase.Protect-Methode

Übernimmt eine mehrerer Schutzarten für das Dokument.

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 Protect ( _
    type As WdProtectionType, _
    ByRef noReset As Object, _
    ByRef password As Object, _
    ByRef useIRM As Object, _
    ByRef enforceStyleLock As Object _
)
public void Protect(
    WdProtectionType type,
    ref Object noReset,
    ref Object password,
    ref Object useIRM,
    ref Object enforceStyleLock
)

Parameter

  • noReset
    Typ: System.Object%
    false, um die Formularfelder auf ihre Standardwerte zurückzusetzen.true, wenn die aktuellen Werte der Formularfelder beibehalten werden sollen, wenn das Dokument geschützt ist.Wenn Type nicht auf wdAllowOnlyFormFields festgelegt wurde, wird das NoReset-Argument ignoriert.
  • password
    Typ: System.Object%
    Das Kennwort, das erforderlich ist, um den Schutz für das Dokument aufzuheben.(Siehe Hinweise unten.)
  • useIRM
    Typ: System.Object%
    Gibt an, ob mithilfe des Information Rights Management (IRM) Unbefugte davon abgehalten werden sollen, Änderungen am Dokument vorzunehmen.
  • enforceStyleLock
    Typ: System.Object%
    Gibt an, ob Formatierungsbeschränkungen in einem geschützten Dokument erzwungen werden sollen.

Hinweise

Wenn ein Dokument geschützt ist, können Benutzer nur begrenzt Änderungen vornehmen, so können sie beispielsweise Anmerkungen hinzufügen, Überarbeitungen durchführen oder ein Formular ausfüllen. Wenn das Dokument bereits geschützt ist, wenn Sie diese Methode verwenden, wird eine Ausnahme ausgelöst.

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.

Optionale Parameter

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

Beispiele

Im folgenden Codebeispiel wird die Protect-Methode verwendet, damit Benutzer dem Dokument nur Kommentare hinzufügen können. Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse in einem Projekt auf Dokumentebene aus.

Private Sub DocumentProtect(ByRef securelyStoredPassword As Object)
    Me.Protect(Word.WdProtectionType.wdAllowOnlyComments, _
        Password:=securelyStoredPassword)
End Sub
private void DocumentProtect(ref object securelyStoredPassword)
{
    this.Protect(Word.WdProtectionType.wdAllowOnlyComments,
        ref missing, ref securelyStoredPassword, ref missing, 
        ref missing);
}

.NET Framework-Sicherheit

Siehe auch

Referenz

DocumentBase Klasse

Microsoft.Office.Tools.Word-Namespace