보호된 Excel 워크시트를 해제하는 것은 데이터 처리 자동화나 최종 사용자를 위한 보고서 준비 시 자주 필요한 작업입니다. Aspose.Cells Cloud SDK for .NET은 워크시트 보호를 수동 작업 없이 제거할 수 있는 강력한 API를 제공합니다. 이 가이드에서는 SDK를 구성하고, 워크북을 업로드하며, 보호 해제 작업을 호출하고, 해제된 파일을 가져오는 방법을 준비된 실행 코드와 cURL 예제와 함께 배웁니다.
Aspose.Cells Cloud SDK for .NET 설정
시작하기 전에 다음을 확인하십시오:
- .NET 6.0 이상이 설치되어 있습니다.
- Client Id와 Client Secret이 포함된 Aspose Cloud 계정.
- .NET 명령을 실행할 수 있는 터미널 또는 IDE에 대한 액세스.
NuGet을 통해 SDK를 설치합니다:
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 클라이언트 생성
시작하려면 환경에서 클라이언트 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 storage에 업로드합니다. 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 워크시트 보호 해제 전체 작업 예제
다음 코드는 단일 콘솔 애플리케이션에서 전체 프로세스를 보여줍니다. 비동기 I/O를 위해 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}'.");
}
}
}
참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로와 구성 값을 실제 환경에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 뒤 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.
cURL 및 REST API를 사용하여 보호된 Excel 시트 잠금 해제
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"
이 명령은 REST 인터페이스를 사용하여 동일한 Aspose.Cells cloud .NET unprotect worksheet 작업을 수행합니다. 자세한 내용은 공식 API 문서를 참조하십시오.
워크시트 보호 해제 성능 최적화
CellsApi인스턴스 재사용 - 각 요청마다 새 클라이언트를 생성하면 오버헤드가 발생합니다. 애플리케이션 수명 동안 단일 인스턴스를 유지하십시오.- 파일을 메모리에 완전히 로드하지 않고 스트림 사용 - SDK의
UploadFileAsync및DownloadFileAsync메서드는 이미 스트림을 사용하므로 대용량 워크북의 메모리 압력을 줄여줍니다. - 보호 해제 호출을 일괄 처리 - 여러 워크시트를 해제해야 하는 경우 워크시트 목록을 한 번 가져온 뒤
UnprotectWorksheetAsync를 반복 호출하고 매번 워크북을 다시 조회하지 마세요. - 비동기 메서드를 블로킹 없이 실행 -
await를 사용하면 클라우드 작업이 완료되는 동안 스레드가 다른 작업을 처리할 수 있어 전체 처리량이 향상됩니다.
마무리
The Aspose.Cells cloud .NET unprotect worksheet 기능을 사용하면 Excel 시트의 보호를 프로그래밍 방식으로 제거할 수 있어 자동화된 데이터 파이프라인에 쉽게 통합할 수 있습니다. 위 단계들을 따라 하면 .NET SDK 또는 직접 REST 호출을 사용하여 워크북을 인증하고, 업로드하고, 보호를 해제하며, 다운로드할 수 있습니다. 프로덕션 사용을 위해 적절한 라이선스를 확보해야 함을 기억하세요; 제품을 평가하는 동안 temporary license page에서 시작할 수 있습니다. 추가 탐색을 위해 Aspose.Cells Cloud SDK for .NET 문서를 확인하고 다른 워크시트 조작 기능을 실험해 보세요.
자주 묻는 질문
-
Aspose.Cells cloud .NET unprotect worksheet가 비밀번호로 보호된 시트를 어떻게 처리합니까?
UnprotectWorksheetAsync호출에 올바른 비밀번호를 제공하면 API가 보호를 해제합니다. 비밀번호가 틀리거나 누락된 경우 오류 응답이 반환됩니다. -
보호된 Excel 시트를 코드를 작성하지 않고 Aspose.Cells .NET으로 잠금 해제할 수 있나요?
예. 동일한 작업은 REST API를 통해 cURL 또는 any HTTP client를 사용하여 수행할 수 있으며, 이 문서의 cURL 섹션에 표시된 대로입니다. -
프로덕션에서 Aspose.Cells Cloud SDK for .NET에 필요한 라이선스는 무엇인가요?
프로덕션 배포에는 상업용 라이선스가 필요합니다. 테스트 중에는 임시 라이선스 페이지에서 임시 라이선스를 얻을 수 있습니다. -
한 워크북에서 여러 워크시트를 한 번에 보호 해제하는 방법이 있나요?
GetWorkbookAsync를 사용하여 워크시트 목록을 가져오고 각 이름을 반복하면서UnprotectWorksheetAsync를 각 시트에 대해 호출할 수 있습니다. 이 접근 방식은 SDK를 사용한 프로그래밍 방식으로 작동합니다.