WriteProtection

WriteProtection class

Gibt Schreibschutzeinstellungen für ein Dokument an.

Um mehr zu erfahren, besuchen Sie dieSchützen oder verschlüsseln Sie ein Dokument Dokumentationsartikel.

public class WriteProtection

Eigenschaften

NameBeschreibung
IsWriteProtected { get; }Gibt zurückWAHR wenn ein Schreibschutzpasswort gesetzt ist.
ReadOnlyRecommended { get; set; }Gibt an, ob der Dokumentautor empfohlen hat, das Dokument schreibgeschützt zu öffnen.

Methoden

NameBeschreibung
SetPassword(string)Legt das Schreibschutzkennwort für das Dokument fest.
ValidatePassword(string)Gibt zurückWAHR Wenn das angegebene Passwort mit dem Schreibschutzpasswort übereinstimmt, mit dem das Dokument geschützt wurde. Wenn das Dokument nicht mit einem Passwort schreibgeschützt ist, wird zurückgegebenFALSCH .

Bemerkungen

Der Schreibschutz gibt an, ob der Autor empfohlen hat, das Dokument schreibgeschützt zu öffnen und/oder ein Kennwort zum Ändern eines Dokuments zu erfordern.

Der Schreibschutz unterscheidet sich vom Dokumentenschutz. Der Schreibschutz wird in Microsoft Word in den Optionen des Dialogfelds „Speichern unter“ angegeben.

Sie erstellen keine Instanzen dieser Klasse direkt. Den Zugriff auf die Dokumentenschutzeinstellungen erreichen Sie überWriteProtection Eigentum.

Beispiele

Zeigt, wie man ein Dokument mit einem Passwort schützt.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Hello world! This document is protected.");
// Geben Sie ein bis zu 15 Zeichen langes Passwort ein und überprüfen Sie dann den Schutzstatus des Dokuments.
doc.WriteProtection.SetPassword("MyPassword");
doc.WriteProtection.ReadOnlyRecommended = true;

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

// Der Schutz verhindert nicht, dass das Dokument programmgesteuert bearbeitet wird, und verschlüsselt auch nicht den Inhalt.
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());

Siehe auch