Розблокування захищеного листа Excel є поширеною вимогою при автоматизації обробки даних або підготовці звітів для кінцевих користувачів. Aspose.Cells Cloud SDK for .NET надає потужний API, який дозволяє видаляти захист листа без ручного втручання. У цьому посібнику ви дізнаєтеся, як налаштувати SDK, завантажити книгу, викликати операцію розблокування та отримати розблокований файл, все це за допомогою готового to‑run коду та прикладів 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 та secret з середовища та створіть об’єкт 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, що спрощує інтеграцію в автоматизовані конвеєри обробки даних. Дотримуючись наведених вище кроків, ви можете автентифікуватися, завантажити, зняти захист і скачати робочі книги, використовуючи або .NET SDK, або прямі REST‑виклики. Не забудьте отримати належну ліцензію для використання у продакшені; під час оцінки продукту ви можете розпочати з сторінки тимчасової ліцензії. Для подальшого вивчення перегляньте документацію Aspose.Cells Cloud SDK for .NET та експериментуйте з іншими можливостями маніпулювання листами.
Поширені запитання
-
Як Aspose.Cells cloud .NET розблоковує листи, захищені паролем?
Коли ви передаєте правильний пароль у викликуUnprotectWorksheetAsync, API знімає захист. Неправильний або відсутній пароль призводить до відповіді з помилкою. -
Чи можу я розблокувати захищений лист Excel за допомогою Aspose.Cells .NET без написання коду?
Так. Ту ж саму операцію можна виконати через REST API, використовуючи cURL або будь‑який HTTP‑клієнт, як показано у розділі cURL цієї статті. -
Яка ліцензія потрібна для Aspose.Cells Cloud SDK for .NET у продакшн?
Для продакшн‑розгортань потрібна комерційна ліцензія. Ви можете отримати тимчасову ліцензію на сторінка тимчасової ліцензії під час тестування. -
Чи можна пакетно зняти захист з кількох листів у одній робочій книзі?
Ви можете отримати список листів за допомогоюGetWorkbookAsyncі перебрати кожну назву, викликаючиUnprotectWorksheetAsyncдля кожного листа. Такий підхід працює програмно за допомогою SDK.