Skip to main content
Row

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

WorksheetCopyOptions.OverwriteProtectionOnLockedWorksheet Property

Specifies whether to apply cell protection options of the source worksheet to cells in the protected destination worksheet.

Namespace: DevExpress.Spreadsheet

Assembly: DevExpress.Spreadsheet.v24.2.Core.dll

NuGet Package: DevExpress.Spreadsheet.Core

#Declaration

public bool OverwriteProtectionOnLockedWorksheet { get; set; }

#Property Value

Type Description
Boolean

true if cells in the protected destination worksheet have the same protection options as the source worksheet cells; overwise, false (default).

#Remarks

If a worksheet where you paste data is protected, you can set the OverwriteProtectionOnLockedWorksheet property to true to copy cell protection settings from the source worksheet and apply them to cells in the destination worksheet.

using DevExpress.Spreadsheet;
// ...

using (Workbook sourceWorkbook = new Workbook())
using (Workbook targetWorkbook = new Workbook())
{
    targetWorkbook.LoadDocument(@"Documents\Book1.xlsx");
    sourceWorkbook.LoadDocument(@"Documents\Book2.xlsx");
    // Add a new worksheet to the destination workbook.
    Worksheet targetSheet = targetWorkbook.Worksheets.Add("Sheet1_Copy");
    // Protect the worksheet.
    targetSheet.Protect("password", WorksheetProtectionPermissions.Default);
    // Specify copy options.
    var copyOptions = new WorksheetCopyOptions()
    {
        OverwriteProtectionOnLockedWorksheet = true
    };
    // Copy data from "Sheet1" in the source workbook
    // to the newly created worksheet in the destination workbook. 
    targetSheet.CopyFrom(sourceWorkbook.Worksheets["Sheet1"], copyOptions);
    targetWorkbook.SaveDocument("Result.xlsx");
}
See Also