Skip to main content
All docs
V25.1
  • Row

    DevExpress v25.1 Update — Your Feedback Matters

    Our What's New in v25.1 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.v25.1.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