How to: Programmatically protect worksheets
Applies to: Visual Studio Visual Studio for Mac Visual Studio Code
The protection feature in Microsoft Office Excel helps prevent users and code from modifying objects in a worksheet. By default, all cells are locked after you turn on protection.
Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Excel. For more information, see Features available by Office application and project type.
In document-level customizations, you can protect worksheets by using the Excel designer. You can also protect a worksheet programmatically at run time in any project type.
You cannot add Windows Forms controls to areas of a worksheet that are protected.
Use the designer
To protect a worksheet in the designer
In the Changes group of the Review tab, click Protect Sheet.
The Protect Sheet dialog box appears. You can set a password and optionally specify certain actions that users are allowed to perform with the worksheet, such as format cells or insert rows.
You can also allow users to edit specific ranges in protected worksheets.
To allow editing in specific ranges
In the Changes group of the Review tab, click Allow Users to Edit Ranges.
The Allow Users to Edit Ranges dialog box appears. You can specify ranges that are unlocked using a password, and users who can edit ranges without a password.
Use code at run time
The following code sets the password (using the variable getPasswordFromUser, which contains a password obtained from the user) and allows only sorting.
To protect a worksheet by using code in a document-level customization
Call the Protect method of the worksheet. This example assumes that you are working with a worksheet named
To protect a worksheet by using code in a VSTO Add-in
Call the Protect method of the active worksheet.
- Work with worksheets
- How to: Programmatically remove protection from worksheets
- How to: Programmatically protect workbooks
- How to: Programmatically hide worksheets
- Host items and host controls overview
- Worksheet host item
- Global access to objects in Office projects
- Optional parameters in Office solutions
Submit and view feedback for