WriteProtection

WriteProtection class

Specifica le impostazioni di protezione in scrittura per un documento.

public class WriteProtection

Proprietà

Nome Descrizione
IsWriteProtected { get; } Restituisce true quando viene impostata una password di protezione in scrittura.
ReadOnlyRecommended { get; set; } Specifica se l’autore del documento ha consigliato di aprire il documento in sola lettura.

Metodi

Nome Descrizione
SetPassword(string) Imposta la password di protezione in scrittura per il documento.
ValidatePassword(string) Restituisce true se la password specificata è la stessa della password di protezione da scrittura con cui il documento è stato protetto. Se il documento non è protetto da scrittura con password, restituisce false.

Osservazioni

La protezione in scrittura specifica se l’autore ha raccomandato di aprire il documento in sola lettura e/o di richiedere una password per modificare un documento.

La protezione in scrittura è diversa dalla protezione dei documenti. La protezione in scrittura è specificata in Microsoft Word nelle opzioni della finestra di dialogo Salva con nome.

Non crei direttamente istanze di questa classe. Si accede alle impostazioni di protezione dei documenti tramite ilWriteProtection proprietà.

Esempi

Mostra come proteggere un documento con una password.

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

// Immettere una password lunga fino a 15 caratteri, quindi verificare lo stato di protezione del documento.
doc.WriteProtection.SetPassword("MyPassword");
doc.WriteProtection.ReadOnlyRecommended = true;

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

// La protezione non impedisce la modifica del documento a livello di codice, né crittografa il contenuto.
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());

Guarda anche