DocumentBase.Protect(WdProtectionType, Object, Object, Object, Object) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.v4.0.Utilities.dll

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.

Übernimmt eine mehrerer Schutzarten für das Dokument.

public void Protect (Microsoft.Office.Interop.Word.WdProtectionType type, ref object noReset, ref object password, ref object useIRM, ref object enforceStyleLock);

member this.Protect : Microsoft.Office.Interop.Word.WdProtectionType * obj * obj * obj * obj -> unit

Public Sub Protect (type As WdProtectionType, Optional ByRef noReset As Object, Optional ByRef password As Object, Optional ByRef useIRM As Object, Optional ByRef enforceStyleLock As Object)

Parameter

type: WdProtectionType

Die Schutzart für das angegebene Dokument. WdProtectionType.

noReset: 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. Andernfalls TypewdAllowOnlyFormFieldswird das NoReset Argument ignoriert.

password: Object

Das Kennwort, das erforderlich ist, um den Schutz für das Dokument aufzuheben. (Siehe Hinweise unten.)

useIRM: Object

Gibt an, ob mithilfe des Information Rights Management (IRM) Unbefugte davon abgehalten werden sollen, Änderungen am Dokument vorzunehmen.

enforceStyleLock: Object

Gibt an, ob Formatierungsbeschränkungen in einem geschützten Dokument erzwungen werden sollen.

Beispiele

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

private void DocumentProtect(ref object securelyStoredPassword)
{
    this.Protect(Word.WdProtectionType.wdAllowOnlyComments,
        ref missing, ref securelyStoredPassword, ref missing, 
        ref missing);
}

Private Sub DocumentProtect(ByRef securelyStoredPassword As Object)
    Me.Protect(Word.WdProtectionType.wdAllowOnlyComments, _
        Password:=securelyStoredPassword)
End Sub

Hinweise

Wenn ein Dokument geschützt ist, können Benutzer nur begrenzte Änderungen vornehmen, z. B. das Hinzufügen von Anmerkungen, das Vornehmen von Überarbeitungen oder das Ausfüllen eines Formulars. Wenn das Dokument bereits geschützt ist, wenn Sie diese Methode verwenden, wird eine Ausnahme ausgelöst.

Vermeiden Sie die Verwendung hartcodierter Kennwörter in Ihren Anwendungen. Wenn in einer Prozedur ein Kennwort erforderlich ist, fordern Sie das Kennwort vom Benutzer an, speichern Sie es in einer Variablen, und verwenden Sie dann die Variable in Ihrem Code.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über