Korumalı bir Excel çalışma sayfasının kilidini açmak, veri işleme otomasyonu veya son kullanıcılar için rapor hazırlama sırasında sıkça ihtiyaç duyulan bir durumdur. Aspose.Cells Cloud SDK for .NET güçlü bir API sunar ve bu API, çalışma sayfası korumasını manuel müdahale olmadan kaldırmanıza olanak tanır. Bu rehberde SDK’yı nasıl yapılandıracağınızı, bir çalışma kitabı yükleyeceğinizi, koruma kaldırma işlemini çağıracağınızı ve kilidi açılmış dosyayı alacağınızı, hazır‑çalıştır kodları ve cURL örnekleriyle öğreneceksiniz.

Aspose.Cells Cloud SDK for .NET’ı Kurma

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • .NET 6.0 veya daha yeni bir sürüm yüklü.
  • Client Id ve Client Secret içeren bir Aspose Cloud hesabı.
  • .NET komutlarını çalıştırabileceğiniz bir terminal veya IDE’ye erişim.

NuGet üzerinden SDK’yı kurun:

dotnet add package Aspose.cells-Cloud

SDK’nin otomatik olarak kimlik doğrulaması yapabilmesi için kimlik bilgilerinizi ortam değişkenleri olarak ayarlayın:

// No additional code needed here; the SDK reads these variables at runtime.

SDK, ASPOSE_CLIENT_ID ve ASPOSE_CLIENT_SECRET değerlerini ortam değişkenlerinden okuyacaktır. Paketi kurduktan ve değişkenleri yapılandırdıktan sonra, Aspose.Cells Cloud depolama ile etkileşen kod yazmaya hazırsınız. Sonraki bölüm, her programlama adımını ayrıntılı olarak ele alır.

Aspose.Cells Cloud .NET Çalışma Sayfasının Korumasını Kaldırma için Adım Adım Kılavuz

Step 1: Load Credentials and Create the API Client

Başlamak için, ortamdan istemci kimliğinizi ve gizlinizi alın ve bir Configuration nesnesi oluşturun. Bu nesne daha sonra CellsApi örneğini oluşturmak için kullanılır.

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);

Adım 2: Korunan Çalışma Kitabını Yükleyin

Yerel Excel dosyasını Aspose Cloud depolama alanına yükleyin. SDK, dosyayı doğrudan akıtarak, tüm dosyanın bellekte tutulması ihtiyacını ortadan kaldırır.

using (var fileStream = File.OpenRead(localInputPath))
{
    var uploadResult = await cellsApi.UploadFileAsync(remoteFilePath, fileStream);
}

Adım 3: Çalışma Kitabı Bilgilerini Alın ve Bir Çalışma Sayfası Seçin

Yükleme işleminden sonra, çalışma kitabı meta verilerini isteyerek çalışma sayfalarının listesini alın. Bu örnek ilk sayfayı seçer, ancak istediğiniz herhangi bir adı belirtebilirsiniz.

var workbookResponse = await cellsApi.GetWorkbookAsync(remoteFileName, folder: remoteFolder);
string sheetName = workbookResponse.Workbook.Worksheets[0].Name;

Adım 4: Çalışma Sayfasının Korumasını Kaldırma

UnprotectWorksheetAsync metodunu çağırın, çalışma sayfası adını ve şifreyi (veya şifre ayarlanmamışsa null) geçirin. Bu, Aspose.Cells cloud .NET unprotect worksheet işleminin çekirdeğidir.

string password = "myPassword"; // replace with actual password or set to null
var unprotectResponse = await cellsApi.UnprotectWorksheetAsync(remoteFileName, sheetName, password, remoteFolder);

Adım 5: Güncellenmiş Çalışma Kitabını İndir

Son olarak, korumanın kaldırıldığını doğrulamak için değiştirilmiş çalışma kitabını yerel makinenize geri indirin.

var downloadStream = await cellsApi.DownloadFileAsync(remoteFilePath);
using (var outputStream = File.Create(localOutputPath))
{
    await downloadStream.CopyToAsync(outputStream);
}

Bu adımlar, kimlik doğrulamadan dosya alımına kadar tam bir Aspose.Cells cloud .NET unprotect worksheet iş akışını gösterir.

Aspose.Cells Cloud .NET Çalışma Sayfasının Korumasını Kaldırma için Tam Çalışan Örnek

Aşağıdaki kod, tek bir konsol uygulamasında tüm süreci gösterir. Bloğu engellemeyen I/O için async/await kullanır ve her API çağrısından sonra hata kontrolü gibi en iyi uygulamaları gösterir.

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}'.");
        }
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyona bakın veya destek ekibi ile iletişime geçin.

cURL ve REST API ile Korunan Excel Sayfasını Açma

C# kodu yazmak istemiyorsanız, aynı sonucu düz HTTP çağrılarıyla elde edebilirsiniz. Aşağıda gerekli cURL komutları bulunmaktadır.

  1. Erişim belirteci alın
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. Korunan çalışma kitabını yükleyin
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. Çalışma sayfasının korumasını kaldır
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. Korumasız çalışma kitabını indirin
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "UnprotectedWorkbook.xlsx"

Bu komutlar, REST arayüzünü kullanarak aynı Aspose.Cells cloud .NET unprotect worksheet işlemini gerçekleştirir. Daha fazla ayrıntı için resmi API belgelerine bakın.

Çalışma Sayfası Korumasını Kaldırma Performansını Optimize Etme

  1. CellsApi örneğini yeniden kullanın - her istek için yeni bir istemci oluşturmak ek yük getirir. Uygulamanızın ömrü boyunca tek bir örnek tutun.
  2. Dosyaları tamamen belleğe yüklemek yerine akış olarak işleyin - SDK’nın UploadFileAsync ve DownloadFileAsync yöntemleri zaten akışları kullanır, bu da büyük çalışma kitapları için bellek baskısını azaltır.
  3. Toplu koruma kaldırma çağrılarını yapın - birçok çalışma sayfasının kilidini açmanız gerekiyorsa, çalışma sayfası listesini bir kez alın ve her seferinde çalışma kitabını yeniden sorgulamadan UnprotectWorksheetAsync içinde döngü yapın.
  4. Asenkron yöntemleri engellemeden çalıştırın - await kullanmak, bulut işlemi tamamlanırken iş parçacığının diğer işleri yürütmesine olanak tanır, bu da genel verimliliği artırır.

Sonuç

The Aspose.Cells cloud .NET unprotect worksheet özelliği, Excel sayfalarındaki korumayı programlı olarak kaldırmanıza olanak tanır ve otomatik veri akışlarına kolayca entegre edilmesini sağlar. Yukarıdaki adımları izleyerek, .NET SDK’sı veya doğrudan REST çağrılarıyla kimlik doğrulaması yapabilir, dosya yükleyebilir, korumayı kaldırabilir ve çalışma kitaplarını indirebilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; ürünü değerlendirirken bir temporary license page ile başlayabilirsiniz. Daha fazla keşif için, Aspose.Cells Cloud SDK for .NET belgelerine göz atın ve diğer çalışma sayfası manipülasyon özelliklerini deneyin.

Sıkça Sorulan Sorular

  • Aspose.Cells cloud .NET unprotect worksheet nasıl şifre korumalı sayfaları yönetir?
    UnprotectWorksheetAsync çağrısında doğru şifreyi sağladığınızda API korumayı kaldırır. Yanlış veya eksik şifre bir hata yanıtı ile sonuçlanır.

  • Korunan bir Excel sayfasını Aspose.Cells .NET kullanarak kod yazmadan açabilir miyim?
    Evet. Aynı işlem, bu makalenin cURL bölümünde gösterildiği gibi cURL veya herhangi bir HTTP istemcisi kullanarak REST API üzerinden gerçekleştirilebilir.

  • Üretim ortamında Aspose.Cells Cloud SDK for .NET için hangi lisans gereklidir?
    Üretim dağıtımları için ticari bir lisans gereklidir. Test ederken geçici lisansı geçici lisans sayfasından alabilirsiniz.

  • Bir çalışma kitabında birden fazla çalışma sayfasını toplu olarak korumasını kaldırmanın bir yolu var mı?
    GetWorkbookAsync ile çalışma sayfalarının listesini alabilir ve her bir adı üzerinde döngü yaparak her sayfa için UnprotectWorksheetAsync çağırabilirsiniz. Bu yaklaşım SDK ile programatik olarak çalışır.