WriteProtection

WriteProtection class

Spécifie les paramètres de protection en écriture pour un document.

public class WriteProtection

Propriétés

Nom La description
IsWriteProtected { get; } Renvoie true lorsqu’un mot de passe de protection en écriture est défini.
ReadOnlyRecommended { get; set; } Spécifie si l’auteur du document a recommandé que le document soit ouvert en lecture seule.

Méthodes

Nom La description
SetPassword(string) Définit le mot de passe de protection en écriture pour le document.
ValidatePassword(string) Renvoie vrai si le mot de passe spécifié est le même que le mot de passe de protection en écriture avec lequel le document était protégé. Si le document n’est pas protégé en écriture par mot de passe, renvoie faux.

Remarques

La protection en écriture spécifie si l’auteur a recommandé que le document soit ouvert en lecture seule et/ou exige un mot de passe pour modifier un document.

La protection en écriture est différente de la protection des documents. La protection en écriture est spécifiée dans Microsoft Word dans les options de la boîte de dialogue Enregistrer sous.

Vous ne créez pas d’instances de cette classe directement. Vous accédez aux paramètres de protection des documents via leWriteProtection propriété.

Exemples

Montre comment protéger un document avec un mot de passe.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Hello world! This document is protected.");

// Entrez un mot de passe de 15 caractères maximum, puis vérifiez l'état de protection du document.
doc.WriteProtection.SetPassword("MyPassword");
doc.WriteProtection.ReadOnlyRecommended = true;

Assert.IsTrue(doc.WriteProtection.IsWriteProtected);
Assert.IsTrue(doc.WriteProtection.ValidatePassword("MyPassword"));

// La protection n'empêche pas le document d'être modifié par programmation, ni ne crypte le contenu.
doc.Save(ArtifactsDir + "Document.WriteProtection.docx");
doc = new Document(ArtifactsDir + "Document.WriteProtection.docx");

Assert.IsTrue(doc.WriteProtection.IsWriteProtected);

builder = new DocumentBuilder(doc);
builder.MoveToDocumentEnd();
builder.Writeln("Writing text in a protected document.");

Assert.AreEqual("Hello world! This document is protected." +
                "\rWriting text in a protected document.", doc.GetText().Trim());

Voir également