보호된 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 명령입니다.

  1. 액세스 토큰 얻기
curl -X POST "https://api.aspose.cloud/connect/token" \
        -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. 보호된 워크북 업로드
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "ProtectedWorkbook.xlsx"
  1. 워크시트 보호 해제
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"
  1. 보호되지 않은 워크북 다운로드
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 문서를 참조하십시오.

워크시트 보호 해제 성능 최적화

  1. CellsApi 인스턴스 재사용 - 각 요청마다 새 클라이언트를 생성하면 오버헤드가 발생합니다. 애플리케이션 수명 동안 단일 인스턴스를 유지하십시오.
  2. 파일을 메모리에 완전히 로드하지 않고 스트림 사용 - SDK의 UploadFileAsync 및 DownloadFileAsync 메서드는 이미 스트림을 사용하므로 대용량 워크북의 메모리 압력을 줄여줍니다.
  3. 보호 해제 호출을 일괄 처리 - 여러 워크시트를 해제해야 하는 경우 워크시트 목록을 한 번 가져온 뒤 UnprotectWorksheetAsync를 반복 호출하고 매번 워크북을 다시 조회하지 마세요.
  4. 비동기 메서드를 블로킹 없이 실행 - 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를 사용한 프로그래밍 방식으로 작동합니다.