保護された Excel ワークシートのロック解除は、データ処理の自動化やエンドユーザー向けレポートの作成時に頻繁に必要となります。Aspose.Cells Cloud SDK for .NET は、手動操作なしでワークシートの保護を解除できる強力な API を提供します。このガイドでは、SDK の設定方法、ワークブックのアップロード、unprotect 操作の呼び出し、そしてロック解除されたファイルの取得方法を、すぐに実行できるコードと 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 ストレージにアップロードします。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}'.");
        }
    }
}

Note: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや設定値を実際の環境に合わせて更新し、すべての必須依存関係が正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメント または サポートチーム にお問い合わせください。

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 を使用すると、クラウド操作が完了する間にスレッドが他の作業を処理でき、全体的なスループットが向上します。

まとめ

Aspose.Cells cloud .NET unprotect worksheet 機能は、プログラムから Excel シートの保護を解除でき、データパイプラインの自動化に簡単に組み込むことができます。上記の手順に従うことで、.NET SDK または直接の REST 呼び出しを使用して、認証、アップロード、保護解除、ブックのダウンロードを行うことができます。 本番環境で使用するには適切なライセンスを取得することを忘れないでください。製品を評価中は、一時ライセンスページ から開始できます。さらに詳しくは、Aspose.Cells Cloud SDK for .NET のドキュメントを確認し、他のワークシート操作機能を試してみてください。

よくある質問

  • Aspose.Cells cloud .NET の unprotect worksheet はパスワードで保護されたシートをどのように処理しますか?
    UnprotectWorksheetAsync 呼び出しで正しいパスワードを指定すると、API は保護を解除します。パスワードが間違っているか指定されていない場合はエラー応答が返されます。

  • コードを書かずに Aspose.Cells .NET を使用して保護された Excel シートのロックを解除できますか?
    はい。同じ操作は REST API を使用して cURL または任意の HTTP クライアントで実行でき、この記事の cURL セクションに示されています。

  • 本番環境で Aspose.Cells Cloud SDK for .NET に必要なライセンスは何ですか?
    本番展開には商用ライセンスが必要です。テスト中は一時ライセンスページから取得できます。

  • 1つのブックで複数のワークシートを一括で保護解除する方法はありますか?
    GetWorkbookAsync を使用してワークシートのリストを取得し、各名前を反復処理して、各シートに対して UnprotectWorksheetAsync を呼び出すことができます。このアプローチは SDK を使用したプログラムで機能します。