DocumentBase.Protect, méthode

  • Article

Applique un des nombreux types de protection au document.

Espace de noms :  Microsoft.Office.Tools.Word
Assembly :  Microsoft.Office.Tools.Word.v4.0.Utilities (dans Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntaxe

'Déclaration
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
)

Paramètres

  • noReset
    Type : System.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
    Type : System.Object%
    Mot de passe requis pour supprimer la protection du document.(Consultez les notes ci-dessous.)
  • useIRM
    Type : System.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
    Type : System.Object%
    Spécifie si les restrictions de mise en forme sont appliquées dans un document protégé.

Notes

Lorsqu'un document est protégé, les utilisateurs peuvent uniquement effectuer des modifications limitées, comme ajouter des annotations, faire des révisions ou remplir 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 à l'utilisateur, stockez-le dans une variable, puis utilisez la variable dans votre code.

Paramètres optionnels

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

Exemples

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

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);
}

Sécurité .NET Framework

Voir aussi

Référence

DocumentBase Classe

Microsoft.Office.Tools.Word, espace de noms