DocumentBase.Protect, méthode
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
- type
Type : Microsoft.Office.Interop.Word.WdProtectionType
Type de protection pour le document spécifié.WdProtectionType.
- 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
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.