Desbloquear uma planilha do Excel protegida é uma necessidade frequente ao automatizar o processamento de dados ou ao preparar relatórios para os usuários finais. Aspose.Cells Cloud SDK for .NET fornece uma API poderosa que permite remover a proteção da planilha sem interação manual. Neste guia, você aprenderá como configurar o SDK, fazer upload de uma pasta de trabalho, chamar a operação de desproteção e recuperar o arquivo desbloqueado, tudo com código pronto‑para‑executar e exemplos de cURL.
Configurando Aspose.Cells Cloud SDK for .NET
Antes de começar, certifique‑se de que você tem o seguinte:
- .NET 6.0 ou posterior instalado.
- Uma conta Aspose Cloud com Client Id e Client Secret.
- Acesso a um terminal ou IDE onde você pode executar comandos .NET.
Instale o SDK via NuGet:
dotnet add package Aspose.cells-Cloud
Defina suas credenciais como variáveis de ambiente para que o SDK possa autenticar automaticamente:
// No additional code needed here; the SDK reads these variables at runtime.
O SDK lerá ASPOSE_CLIENT_ID e ASPOSE_CLIENT_SECRET do ambiente. Após instalar o pacote e configurar as variáveis, você está pronto para escrever código que interage com o armazenamento Aspose.Cells Cloud. A próxima seção percorre cada passo de programação.
Guia passo a passo para Aspose.Cells Cloud .NET Desproteger planilha
Etapa 1: Carregar Credenciais e Criar o Cliente da API
Para começar, recupere seu ID de cliente e segredo do ambiente e crie um objeto Configuration. Esse objeto é então usado para instanciar 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);
Etapa 2: Carregar a Pasta de Trabalho Protegida
Carregue o arquivo Excel local no armazenamento da Aspose Cloud. O SDK transmite o arquivo diretamente, evitando a necessidade de manter todo o arquivo na memória.
using (var fileStream = File.OpenRead(localInputPath))
{
var uploadResult = await cellsApi.UploadFileAsync(remoteFilePath, fileStream);
}
Etapa 3: Recuperar informações da pasta de trabalho e escolher uma planilha
Após o upload, solicite os metadados da pasta de trabalho para obter a lista de planilhas. Este exemplo seleciona a primeira planilha, mas você pode especificar qualquer nome.
var workbookResponse = await cellsApi.GetWorkbookAsync(remoteFileName, folder: remoteFolder);
string sheetName = workbookResponse.Workbook.Worksheets[0].Name;
Etapa 4: Desproteger a Planilha
Chame o método UnprotectWorksheetAsync, passando o nome da planilha e a senha (ou null se nenhuma senha estiver definida). Esta é a parte central da operação 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);
Etapa 5: Baixar a Pasta de Trabalho Atualizada
Finalmente, baixe a pasta de trabalho modificada de volta para sua máquina local para verificar se a proteção foi removida.
var downloadStream = await cellsApi.DownloadFileAsync(remoteFilePath);
using (var outputStream = File.Create(localOutputPath))
{
await downloadStream.CopyToAsync(outputStream);
}
Estas etapas ilustram um fluxo de trabalho completo Aspose.Cells cloud .NET desproteger planilha, desde a autenticação até a recuperação do arquivo.
Exemplo completo em funcionamento para Aspose.Cells Cloud .NET Desproteger Planilha
O código a seguir mostra todo o processo em uma única aplicação de console. Ele usa async/await para I/O não bloqueante e demonstra as melhores práticas, como verificação de erros após cada chamada de 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}'.");
}
}
}
Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão instaladas corretamente e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.
Desbloqueando Planilha do Excel Protegida com cURL e a API REST
Se você preferir não escrever código C#, pode obter o mesmo resultado com chamadas HTTP simples. Abaixo estão os comandos cURL necessários.
- Obter um token de acesso
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Carregue a pasta de trabalho protegida
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-T "ProtectedWorkbook.xlsx"
- Desproteger a planilha
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"
- Baixe a pasta de trabalho desprotegida
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "UnprotectedWorkbook.xlsx"
Esses comandos executam a mesma operação Aspose.Cells cloud .NET unprotect worksheet usando a interface REST. Para mais detalhes, veja a documentação oficial da API.
Otimizando o Desempenho da Desproteção da Planilha
- Reutilize a instância
CellsApi- criar um novo cliente para cada solicitação adiciona sobrecarga. Mantenha uma única instância durante a vida útil da sua aplicação. - Transmita arquivos em vez de carregá‑los completamente na memória - os métodos
UploadFileAsynceDownloadFileAsyncdo SDK já utilizam streams, o que reduz a pressão de memória para grandes pastas de trabalho. - Agrupe chamadas de desproteção - se precisar desbloquear muitas planilhas, recupere a lista de planilhas uma vez e itere sobre
UnprotectWorksheetAsyncsem consultar novamente a pasta de trabalho a cada vez. - Execute os métodos assíncronos sem bloqueio - usar
awaitpermite que a thread execute outras tarefas enquanto a operação na nuvem é concluída, melhorando o rendimento geral.
Concluindo
A capacidade Aspose.Cells cloud .NET unprotect worksheet permite que você remova programaticamente a proteção de planilhas Excel, facilitando a integração em pipelines de dados automatizados. Seguindo as etapas acima, você pode autenticar, fazer upload, remover a proteção e baixar pastas de trabalho usando o SDK .NET ou chamadas REST diretas. Lembre‑se de adquirir uma licença adequada para uso em produção; você pode começar com uma página de licença temporária enquanto avalia o produto. Para uma exploração mais aprofundada, consulte a documentação do Aspose.Cells Cloud SDK for .NET e experimente outros recursos de manipulação de planilhas.
Perguntas Frequentes
-
Como o recurso de desproteger planilha do Aspose.Cells cloud .NET lida com planilhas protegidas por senha?
Quando você fornece a senha correta na chamadaUnprotectWorksheetAsync, a API remove a proteção. Uma senha incorreta ou ausente resulta em uma resposta de erro. -
Posso desbloquear uma planilha do Excel protegida usando Aspose.Cells .NET sem escrever código?
Sim. A mesma operação pode ser realizada via a API REST usando cURL ou qualquer cliente HTTP, como mostrado na seção cURL deste artigo. -
Qual licença é necessária para o Aspose.Cells Cloud SDK for .NET em produção?
É necessária uma licença comercial para implantações em produção. Você pode obter uma licença temporária na página de licença temporária durante os testes. -
Existe uma forma de remover a proteção de várias planilhas de uma só vez em um workbook?
Você pode obter a lista de planilhas comGetWorkbookAsynce iterar sobre cada nome, chamandoUnprotectWorksheetAsyncpara cada planilha. Essa abordagem funciona programaticamente com o SDK.