WriteProtection

WriteProtection class

Gibt die Schreibschutzeinstellungen für ein Dokument an.

Um mehr zu erfahren, besuchen Sie dieSchützen oder Verschlüsseln eines Dokuments Dokumentationsartikel.

public class WriteProtection

Eigenschaften

NameBeschreibung
IsWriteProtected { get; }RückgabenWAHR wenn ein Schreibschutzkennwort festgelegt ist.
ReadOnlyRecommended { get; set; }Gibt an, ob der Autor des Dokuments empfohlen hat, das Dokument schreibgeschützt zu öffnen.

Methoden

NameBeschreibung
SetPassword(string)Legt das Schreibschutzkennwort für das Dokument fest.
ValidatePassword(string)RückgabenWAHR 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 Folgendes zurückgegeben:FALSCH .

Bemerkungen

Der Schreibschutz gibt an, ob der Autor empfohlen hat, das Dokument nur lesbar zu öffnen und/oder zum Ändern eines Dokuments ein Kennwort anzufordern.

Schreibschutz ist nicht mit Dokumentschutz identisch. Schreibschutz wird in Microsoft Word in den Optionen des Dialogfelds „Speichern unter“ festgelegt.

Sie erstellen keine Instanzen dieser Klasse direkt. Sie greifen auf die Dokumentschutzeinstellungen über dieWriteProtection Eigentum.

Beispiele

Zeigt, wie Sie ein Dokument mit einem Kennwort schützen.

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 anschließend 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 weder die programmgesteuerte Bearbeitung des Dokuments noch verschlüsselt er 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

ViewType Enum ZoomType Enum