Разблокировка защищённого листа Excel часто требуется при автоматизации обработки данных или подготовке отчётов для конечных пользователей. Aspose.Cells Cloud SDK for .NET предоставляет мощный API, позволяющий удалять защиту листа без ручного вмешательства. В этом руководстве вы узнаете, как настроить SDK, загрузить книгу, вызвать операцию снятия защиты и получить разблокированный файл, используя готовый к запуску код и примеры cURL.
Настройка Aspose.Cells Cloud SDK for .NET
Прежде чем начать, убедитесь, что у вас есть следующее:
- .NET 6.0 или более поздней версии установлен.
- Учётная запись Aspose Cloud с Client Id и Client Secret.
- Доступ к терминалу или IDE, где вы можете выполнять команды .NET.
Установите SDK через NuGet:
dotnet add package Aspose.cells-Cloud
Установите свои учетные данные в виде переменных окружения, чтобы SDK мог автоматически аутентифицироваться:
// No additional code needed here; the SDK reads these variables at runtime.
SDK будет считывать ASPOSE_CLIENT_ID и ASPOSE_CLIENT_SECRET из переменных окружения. После установки пакета и настройки переменных вы готовы писать код, взаимодействующий с хранилищем Aspose.Cells Cloud. Следующий раздел проходит каждый программный шаг.
Пошаговое руководство по Aspose.Cells Cloud .NET Снятие защиты листа
Шаг 1: Загрузка учетных данных и создание клиента API
Для начала получите идентификатор клиента (client ID) и секрет из переменных окружения и создайте объект Configuration. Этот объект затем используется для создания экземпляра CellsApi.
var clientId = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_ID");
var clientSecret = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_SECRET");
var config = new Configuration
{
ClientId = clientId,
ClientSecret = clientSecret,
BasePath = "https://api.aspose.cloud"
};
var cellsApi = new CellsApi(config);
Шаг 2: Загрузка защищённой рабочей книги
Загрузите локальный файл Excel в хранилище Aspose Cloud. SDK передаёт файл потоково, избегая необходимости держать весь файл в памяти.
using (var fileStream = File.OpenRead(localInputPath))
{
var uploadResult = await cellsApi.UploadFileAsync(remoteFilePath, fileStream);
}
Шаг 3: Получить информацию о рабочей книге и выбрать лист
После загрузки запросите метаданные рабочей книги, чтобы получить список листов. В этом примере выбирается первый лист, но вы можете указать любое имя.
var workbookResponse = await cellsApi.GetWorkbookAsync(remoteFileName, folder: remoteFolder);
string sheetName = workbookResponse.Workbook.Worksheets[0].Name;
Шаг 4: Снять защиту с листа
Вызовите метод UnprotectWorksheetAsync, передавая имя листа и пароль (или null, если пароль не установлен). Это основа операции Aspose.Cells cloud .NET unprotect worksheet.
string password = "myPassword"; // replace with actual password or set to null
var unprotectResponse = await cellsApi.UnprotectWorksheetAsync(remoteFileName, sheetName, password, remoteFolder);
Шаг 5: Скачайте обновленную рабочую книгу
Наконец, скачайте изменённую рабочую книгу обратно на ваш локальный компьютер, чтобы убедиться, что защита была удалена.
var downloadStream = await cellsApi.DownloadFileAsync(remoteFilePath);
using (var outputStream = File.Create(localOutputPath))
{
await downloadStream.CopyToAsync(outputStream);
}
Эти шаги демонстрируют полный Aspose.Cells cloud .NET unprotect worksheet рабочий процесс, от аутентификации до получения файла.
Полный рабочий пример для Aspose.Cells Cloud .NET Снятие защиты листа
Следующий код демонстрирует весь процесс в одном консольном приложении. Он использует async/await для неблокирующего ввода‑вывода и показывает лучшие практики, такие как проверка ошибок после каждого вызова API.
using System;
using System.IO;
using System.Threading.Tasks;
using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Client;
using Aspose.Cells.Cloud.SDK.Model;
namespace AsposeCellsUnprotectDemo
{
class Program
{
static async Task Main(string[] args)
{
// Aspose Cloud credentials – set these environment variables before running
var clientId = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_ID");
var clientSecret = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_SECRET");
var config = new Configuration
{
ClientId = clientId,
ClientSecret = clientSecret,
BasePath = "https://api.aspose.cloud"
};
var cellsApi = new CellsApi(config);
// Local file to upload (must exist) and remote storage details
string localInputPath = "ProtectedWorkbook.xlsx";
string remoteFolder = "Temp";
string remoteFileName = "ProtectedWorkbook.xlsx";
string remoteFilePath = $"{remoteFolder}/{remoteFileName}";
// Upload the protected workbook to Aspose Cloud storage
using (var fileStream = File.OpenRead(localInputPath))
{
var uploadResult = await cellsApi.UploadFileAsync(remoteFilePath, fileStream);
if (uploadResult == null || (uploadResult.Errors != null && uploadResult.Errors.Count > 0))
{
Console.WriteLine("Upload failed.");
return;
}
}
// Retrieve workbook information to get worksheet names
var workbookResponse = await cellsApi.GetWorkbookAsync(remoteFileName, folder: remoteFolder);
if (workbookResponse?.Workbook?.Worksheets == null || workbookResponse.Workbook.Worksheets.Count == 0)
{
Console.WriteLine("Unable to retrieve workbook or worksheets.");
return;
}
// Choose the first worksheet (or specify a name directly)
string sheetName = workbookResponse.Workbook.Worksheets[0].Name;
// Unprotect the worksheet – provide password if the sheet is password‑protected; otherwise null
string password = "myPassword"; // replace with actual password or set to null
var unprotectResponse = await cellsApi.UnprotectWorksheetAsync(remoteFileName, sheetName, password, remoteFolder);
if (unprotectResponse == null || unprotectResponse.Code != 200)
{
Console.WriteLine($"Failed to unprotect worksheet '{sheetName}'.");
return;
}
// Download the updated workbook
var downloadStream = await cellsApi.DownloadFileAsync(remoteFilePath);
string localOutputPath = "UnprotectedWorkbook.xlsx";
using (var outputStream = File.Create(localOutputPath))
{
await downloadStream.CopyToAsync(outputStream);
}
Console.WriteLine($"Worksheet '{sheetName}' has been unprotected and saved as '{localOutputPath}'.");
}
}
}
Примечание: Этот пример кода демонстрирует базовый функционал. Прежде чем использовать его в вашем проекте, убедитесь, что обновили все пути к файлам и значения конфигурации в соответствии с вашей реальной средой, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если возникнут проблемы, обратитесь к официальной документации или свяжитесь с командой поддержки для получения помощи.
Разблокировка защищённого листа Excel с помощью cURL и REST API
Если вы предпочитаете не писать код на C#, вы можете достичь того же результата с помощью обычных HTTP‑запросов. Ниже приведены необходимые команды cURL.
- Получить токен доступа
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Загрузите защищённую рабочую книгу
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-T "ProtectedWorkbook.xlsx"
- Снять защиту листа
curl -X POST "https://api.aspose.cloud/v3.0/cells/ProtectedWorkbook.xlsx/worksheets/Sheet1/unprotect?folder=Temp&password=myPassword" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- Скачать незащищённую рабочую книгу
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "UnprotectedWorkbook.xlsx"
Эти команды выполняют ту же операцию Aspose.Cells cloud .NET unprotect worksheet с использованием REST‑интерфейса. Для получения более подробной информации см. официальную документацию API.
Оптимизация производительности снятия защиты листа
- Повторное использование экземпляра
CellsApi- создание нового клиента для каждого запроса добавляет накладные расходы. Держите один экземпляр на протяжении всего срока жизни вашего приложения. - Передавайте файлы потоками вместо полной загрузки в память - методы SDK
UploadFileAsyncиDownloadFileAsyncуже используют потоки, что уменьшает нагрузку на память при работе с большими рабочими книгами. - Группировать вызовы снятия защиты - если нужно разблокировать множество листов, получите список листов один раз и проходите в цикле
UnprotectWorksheetAsync, не запрашивая книгу каждый раз. - Запускайте асинхронные методы без блокировки - использование
awaitпозволяет потоку выполнять другую работу, пока завершается облачная операция, повышая общую пропускную способность.
Подведение итогов
Возможность Aspose.Cells cloud .NET unprotect worksheet позволяет программно удалять защиту с листов Excel, упрощая интеграцию в автоматизированные конвейеры данных. Следуя приведённым выше шагам, вы можете аутентифицироваться, загружать, снимать защиту и скачивать книги Excel, используя либо .NET SDK, либо прямые REST‑вызовы. Не забудьте получить соответствующую лицензию для использования в продакшене; вы можете начать с страницы временной лицензии во время оценки продукта. Для дальнейшего изучения ознакомьтесь с документацией Aspose.Cells Cloud SDK for .NET и поэкспериментируйте с другими возможностями манипуляции листами.
Часто задаваемые вопросы
-
Как Aspose.Cells cloud .NET unprotect worksheet обрабатывает листы, защищённые паролем?
Когда вы передаёте правильный пароль в вызовеUnprotectWorksheetAsync, API снимает защиту. Неправильный или отсутствующий пароль приводит к ошибке в ответе. -
Могу ли я разблокировать защищённый лист Excel, используя Aspose.Cells .NET без написания кода?
Да. Тот же процесс можно выполнить через REST API, используя cURL или любой HTTP‑клиент, как показано в разделе cURL этой статьи. -
Какой тип лицензии требуется для Aspose.Cells Cloud SDK for .NET в продакшене?
Для продакшен‑развертываний требуется коммерческая лицензия. Вы можете получить временную лицензию со страницы временной лицензии во время тестирования. -
Есть ли способ массово снять защиту с нескольких листов в одной рабочей книге?
Вы можете получить список листов с помощьюGetWorkbookAsyncи пройтись по каждому имени, вызываяUnprotectWorksheetAsyncдля каждого листа. Такой подход работает программно с SDK.