Расширенные настройки защиты с Excel XP с Node.js через C++

С момента выпуска Excel 2002 или XP, Microsoft добавила множество расширенных настроек защиты.

Введение

Эти настройки защиты ограничивают или разрешают пользователям:

Удалить строки или столбцы.
Редактировать содержимое, объекты или сценарии.
Форматировать ячейки, строки или столбцы.
Вставлять строки, столбцы или гиперссылки.
Выбирать заблокированные или разблокированные ячейки.
Использовать сводные таблицы и многое другое.

Aspose.Cells for Node.js via C++ поддерживает все расширенные настройки защиты, предлагаемые начиная с Excel XP и более поздних версий.

Настройки расширенной защиты с использованием Excel XP и более поздних версий

Чтобы просмотреть доступные настройки защиты в Excel XP:

Из меню Инструменты выберите Защита, а затем Защитить лист. Будет отображено диалоговое окно.

Чтобы просмотреть доступные настройки защиты в Excel 2016:

В меню Файл выберите Защита книги, а затем Защитить текущий лист.
Выберите Защитить лист в меню Проверка.

Следующие шаги откроют диалоговое окно, в котором вы можете разрешить или ограничить функции листа или применить пароль к листу.

Расширенные настройки защиты с использованием Aspose.Cells for Node.js via C++

Aspose.Cells for Node.js via C++ поддерживает все расширенные настройки защиты.

Aspose.Cells предоставляет класс Workbook, который представляет файл Microsoft Excel. Класс Workbook содержит коллекцию Worksheets, позволяющую получить доступ к каждому листу в файле Excel. Лист представлен классом Worksheet.

Класс Worksheet предоставляет свойство getProtection(), которое используется для применения этих расширенных настроек защиты. Свойство getProtection() является объектом класса Protection, который инкапсулирует несколько булевых свойств для отключения или включения ограничений.

Ниже приведен небольшой пример приложения. Он открывает файл Excel и использует большинство поддерживаемых Excel XP и более поздних версий настроек защиты.

try {
const path = require("path");
const fs = require("fs");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const filePath = path.join(dataDir, "book1.xls");

// Creating a file stream containing the Excel file to be opened
const fstream = fs.createReadStream(filePath);

// Reading the file stream into a buffer
const fileBuffer = [];
fstream.on('data', chunk => fileBuffer.push(chunk));
fstream.on('end', () => {
const workbook = new AsposeCells.Workbook(Buffer.concat(fileBuffer));

// Accessing the first worksheet in the Excel file
const worksheet = workbook.getWorksheets().get(0);

// Restricting users to delete columns of the worksheet
worksheet.getProtection().setAllowDeletingColumn(false);

// Restricting users to delete row of the worksheet
worksheet.getProtection().setAllowDeletingRow(false);

// Restricting users to edit contents of the worksheet
worksheet.getProtection().setAllowEditingContent(false);

// Restricting users to edit objects of the worksheet
worksheet.getProtection().setAllowEditingObject(false);

// Restricting users to edit scenarios of the worksheet
worksheet.getProtection().setAllowEditingScenario(false);

// Restricting users to filter
worksheet.getProtection().setAllowFiltering(false);

// Allowing users to format cells of the worksheet
worksheet.getProtection().setAllowFormattingCell(true);

// Allowing users to format rows of the worksheet
worksheet.getProtection().setAllowFormattingRow(true);

// Allowing users to insert columns in the worksheet
worksheet.getProtection().setAllowFormattingColumn(true);

// Allowing users to insert hyperlinks in the worksheet
worksheet.getProtection().setAllowInsertingHyperlink(true);

// Allowing users to insert rows in the worksheet
worksheet.getProtection().setAllowInsertingRow(true);

// Allowing users to select locked cells of the worksheet
worksheet.getProtection().setAllowSelectingLockedCell(true);

// Allowing users to select unlocked cells of the worksheet
worksheet.getProtection().setAllowSelectingUnlockedCell(true);

// Allowing users to sort
worksheet.getProtection().setAllowSorting(true);

// Allowing users to use pivot tables in the worksheet
worksheet.getProtection().setAllowUsingPivotTable(true);

// Saving the modified Excel file
workbook.save(path.join(dataDir, "output.xls"), AsposeCells.SaveFormat.Excel97To2003);

// Closing the file stream to free all resources
fstream.close();

Пожалуйста, не вызывайте метод protect(ProtectionType) класса Worksheet при использовании свойства getProtection(). Также сохраните файл в форматах Excel97To2003 или Xlsx, потому что расширенные настройки защиты поддерживаются только в Excel XP и более поздних версиях.

Проблема блокировки ячеек

Если вы хотите ограничить редактирование ячеек пользователями, ячейки должны быть защищены (заблокированы) перед применением любых настроек защиты. В противном случае, ячейки могут редактироваться даже если лист защищен. В Microsoft Excel XP ячейки можно заблокировать через следующий диалог:

Диалог для блокировки ячеек в Excel XP

Также возможно заблокировать ячейки с помощью API Aspose.Cells. Каждая ячейка может иметь формат Style, который содержит логическое свойство isLocked(). Установите свойство isLocked() в true или false, чтобы заблокировать или разблокировать ячейку.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const filePath = path.join(dataDir, "Book1.xlsx");
// Loads the workbook which contains hidden external links
const workbook = new AsposeCells.Workbook(filePath);

// Accessing the first worksheet in the Excel file
const worksheet = workbook.getWorksheets().get(0);

worksheet.getCells().get("A1").getStyle().setIsLocked(true);
// Finally, Protect the sheet now.
worksheet.protect(AsposeCells.ProtectionType.All);
workbook.save(path.join(dataDir, "output.xlsx"));

Разблокировать лист с Node.js через C++ Обнаружение, заблокирован ли лист паролем, с помощью Node.js через C++