Back to Devexpress

Workbook.Unprotect(String) Method

officefileapi-devexpress-dot-spreadsheet-dot-workbook-dot-unprotect-x28-system-dot-string-x29.md

latest4.4 KB
Original Source

Workbook.Unprotect(String) Method

Removes protection from a workbook.

You need a license for the DevExpress Office File API Subscription or DevExpress Universal Subscription to use this method in production code.

Namespace : DevExpress.Spreadsheet

Assembly : DevExpress.Docs.v25.2.dll

NuGet Package : DevExpress.Document.Processor

Declaration

csharp
public bool Unprotect(
    string password
)
vb
Public Function Unprotect(
    password As String
) As Boolean

Parameters

NameTypeDescription
passwordString

A string that specifies the password with which the workbook is protected.

|

Returns

TypeDescription
Boolean

true if protection is successfully removed; otherwise, false.

|

Remarks

If the workbook is not protected, the Unprotect method raises an exception. Use the Workbook.IsProtected property to check whether the workbook is already protected.

Example

View Example

csharp
Worksheet worksheet = workbook.Worksheets["ProtectionSample"];
workbook.Worksheets.ActiveWorksheet = worksheet;

// Unprotect the workbook (requires the password).
if (workbook.IsProtected)
    workbook.Unprotect("password");
// Add a note.
worksheet["B2"].Value = "Workbook is unprotected. Workheets can be added, moved or deleted.";
worksheet.Visible = true;
vb
Dim worksheet As Worksheet = workbook.Worksheets("ProtectionSample")
workbook.Worksheets.ActiveWorksheet = worksheet

' Unprotect the workbook using a password.
If workbook.IsProtected Then
    workbook.Unprotect("password")
End If
' Add a note.
worksheet("B2").Value = "Workbook is unprotected. Workheets can be added, moved or deleted."
worksheet.Visible = True

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the Unprotect(String) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

spreadsheet-document-api-examples-part2/CS/SpreadsheetDocServerAPIPart2/CodeExamples/ProtectionActions.cs#L38

csharp
if (workbook.IsProtected)
    workbook.Unprotect("password");
// Add a note.

spreadsheet-document-api-examples-part2/VB/SpreadsheetDocServerAPIPart2/CodeExamples/ProtectionActions.vb#L35

vb
If workbook.IsProtected Then
    workbook.Unprotect("password")
End If

Implements

Unprotect(String)

See Also

Protect(String, Boolean, Boolean)

IsProtected

Workbook Class

Workbook Members

DevExpress.Spreadsheet Namespace