WriteProtection

WriteProtection class

Specifica le impostazioni di protezione da scrittura per un documento.

Per saperne di più, visita ilProteggere o crittografare un documento articolo di documentazione.

public class WriteProtection

Proprietà

NomeDescrizione
IsWriteProtected { get; }RestituisceVERO quando è impostata una password di protezione da scrittura.
ReadOnlyRecommended { get; set; }Specifica se l’autore del documento ha raccomandato di aprirlo in sola lettura.

Metodi

NomeDescrizione
SetPassword(string)Imposta la password di protezione da scrittura per il documento.
ValidatePassword(string)RestituisceVERO se la password specificata è la stessa della password di protezione da scrittura con cui è stato protetto il documento. Se il documento non è protetto da scrittura con password, allora restituiscefalso .

Osservazioni

La protezione da scrittura specifica se l’autore ha raccomandato che il documento venga aperto in sola lettura e/o che venga richiesta una password per modificarlo.

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

Non è possibile creare istanze di questa classe direttamente. È possibile accedere alle impostazioni di protezione del documento tramiteWriteProtection 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.");
// Inserisci una password lunga fino a 15 caratteri, quindi verifica 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 che il documento venga modificato a livello di programmazione, né ne 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