Aspose::Words::Document::Unprotect method

Document::Unprotect() method

Removes protection from the document regardless of the password.

void Aspose::Words::Document::Unprotect()

Remarks

This method unprotects the document even if it has a protection password.

Note that document protection is different from write protection. Write protection is specified using the WriteProtection.

Examples

Shows how to protect and unprotect a document.

auto doc = System::MakeObject<Aspose::Words::Document>();
doc->Protect(ProtectionType::ReadOnly, u"password");

ASSERT_EQ(doc->get_ProtectionType(), ProtectionType::ReadOnly);

// If we open this document with Microsoft Word intending to edit it,
// we will need to apply the password to get through the protection.
doc->Save(get_ArtifactsDir() + u"Document.Protect.docx");

// Note that the protection only applies to Microsoft Word users opening our document.
// We have not encrypted the document in any way, and we do not need the password to open and edit it programmatically.
auto protectedDoc = System::MakeObject<Aspose::Words::Document>(System::String(get_ArtifactsDir() + u"Document.Protect.docx"));

ASSERT_EQ(protectedDoc->get_ProtectionType(), ProtectionType::ReadOnly);

auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(protectedDoc);
builder->Writeln(u"Text added to a protected document.");

// There are two ways of removing protection from a document.
// 1 - With no password:
doc->Unprotect();

ASSERT_EQ(doc->get_ProtectionType(), ProtectionType::NoProtection);

doc->Protect(ProtectionType::ReadOnly, u"NewPassword");

ASSERT_EQ(doc->get_ProtectionType(), ProtectionType::ReadOnly);

doc->Unprotect(u"WrongPassword");

ASSERT_EQ(doc->get_ProtectionType(), ProtectionType::ReadOnly);

// 2 - With the correct password:
doc->Unprotect(u"NewPassword");

ASSERT_EQ(doc->get_ProtectionType(), ProtectionType::NoProtection);

See Also

Document::Unprotect(const System::String &) method

Removes protection from the document if a correct password is specified.

_Bool Aspose::Words::Document::Unprotect(const System::String & password)
ParameterTypeDescription
passwordconst System::String &The password to unprotect the document with.

ReturnValue

true if a correct password was specified and the document was unprotected.

Remarks

This method unprotects the document only if a correct password is specified.

Note that document protection is different from write protection. Write protection is specified using the WriteProtection.

Examples

Shows how to protect and unprotect a document.

auto doc = System::MakeObject<Aspose::Words::Document>();
doc->Protect(ProtectionType::ReadOnly, u"password");

ASSERT_EQ(doc->get_ProtectionType(), ProtectionType::ReadOnly);

// If we open this document with Microsoft Word intending to edit it,
// we will need to apply the password to get through the protection.
doc->Save(get_ArtifactsDir() + u"Document.Protect.docx");

// Note that the protection only applies to Microsoft Word users opening our document.
// We have not encrypted the document in any way, and we do not need the password to open and edit it programmatically.
auto protectedDoc = System::MakeObject<Aspose::Words::Document>(System::String(get_ArtifactsDir() + u"Document.Protect.docx"));

ASSERT_EQ(protectedDoc->get_ProtectionType(), ProtectionType::ReadOnly);

auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(protectedDoc);
builder->Writeln(u"Text added to a protected document.");

// There are two ways of removing protection from a document.
// 1 - With no password:
doc->Unprotect();

ASSERT_EQ(doc->get_ProtectionType(), ProtectionType::NoProtection);

doc->Protect(ProtectionType::ReadOnly, u"NewPassword");

ASSERT_EQ(doc->get_ProtectionType(), ProtectionType::ReadOnly);

doc->Unprotect(u"WrongPassword");

ASSERT_EQ(doc->get_ProtectionType(), ProtectionType::ReadOnly);

// 2 - With the correct password:
doc->Unprotect(u"NewPassword");

ASSERT_EQ(doc->get_ProtectionType(), ProtectionType::NoProtection);

See Also