DocumentBase.Protect(WdProtectionType, Object, Object, Object, Object) Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Word

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Applique un des nombreux types de protection au document.

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)

Paramètres

type: WdProtectionType

Type de protection pour le document spécifié. WdProtectionType.

noReset: Object

false pour réinitialiser les valeurs par défaut des champs de formulaire. true pour conserver les valeurs en cours des champs de formulaire si le document est protégé. Si Type n’est pas wdAllowOnlyFormFields, l’argument NoReset est ignoré.

password: Object

Mot de passe requis pour supprimer la protection du document. (Consultez les notes ci-dessous.)

useIRM: Object

Spécifie s'il faut utiliser la Gestion des droits relatifs à l'information (IRM) lors de la protection du document contre les modifications.

enforceStyleLock: Object

Spécifie si les restrictions de mise en forme sont appliquées dans un document protégé.

Exemples

L’exemple de code suivant utilise la Protect méthode pour autoriser les utilisateurs à ajouter uniquement des commentaires au document. Pour utiliser cet exemple, exécutez-le à partir de la ThisDocument classe dans un projet au niveau du document.

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

Remarques

Lorsqu’un document est protégé, les utilisateurs ne peuvent apporter que des modifications limitées, telles que l’ajout d’annotations, des révisions ou la compléteur d’un formulaire. Si le document est déjà protégé lorsque vous utilisez cette méthode, une exception est levée.

Évitez d’utiliser des mots de passe codés en dur dans vos applications. Si un mot de passe est requis dans une procédure, demandez le mot de passe à l’utilisateur, stockez-le dans une variable, puis utilisez la variable dans votre code.

Paramètres facultatifs

Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.

S’applique à