DocumentBase.Protect-Methode

Artikel
08/10/2011

Ü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

type
Typ: Microsoft.Office.Interop.Word.WdProtectionType
Die Schutzart für das angegebene Dokument.WdProtectionType.

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

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

DocumentBase Klasse

Microsoft.Office.Tools.Word-Namespace

Freigeben über