A védett Excel munkalap feloldása gyakori követelmény adatfeldolgozás automatizálásakor vagy jelentések végfelhasználók számára történő előkészítésekor. Aspose.Cells Cloud SDK for .NET egy erőteljes API-t biztosít, amely lehetővé teszi a munkalap védelem eltávolítását manuális beavatkozás nélkül. Ebben az útmutatóban megtanulja, hogyan konfigurálja az SDK-t, tölt fel egy munkafüzetet, hívja meg a feloldási műveletet, és szerezze meg a feloldott fájlt, mindezt kész‑kód és cURL példákkal.
Az Aspose.Cells Cloud SDK beállítása .NET-hez
Mielőtt elkezdené, győződjön meg róla, hogy a következőkkel rendelkezik:
- .NET 6.0 vagy újabb telepítve.
- Egy Aspose Cloud fiók Client Id és Client Secret értékekkel.
- Hozzáférés egy terminálhoz vagy IDE‑hez, ahol .NET parancsokat futtathat.
Telepítse az SDK-t a NuGet-en keresztül:
dotnet add package Aspende.cells-Cloud
Állítsa be a hitelesítő adatait környezeti változóként, hogy az SDK automatikusan hitelesíthessen:
// No additional code needed here; the SDK reads these variables at runtime.
Az SDK a környezetből olvassa a ASPOSE_CLIENT_ID és ASPOSE_CLIENT_SECRET értékeket. A csomag telepítése és a változók konfigurálása után készen állsz arra, hogy kódot írj, amely az Aspose.Cells Cloud tárolóval lép interakcióba. A következő szakasz lépésről lépésre bemutatja a programozási lépéseket.
Lépésről‑lépésre útmutató az Aspose.Cells Cloud .NET munkalap védelmének feloldásához
1. lépés: Hitelesítő adatok betöltése és az API kliens létrehozása
Először is, szerezze be a kliensazonosítót és a titkos kulcsot a környezetből, és hozza létre a Configuration objektumot. Ez az objektum ezután a CellsApi példányosításához használható.
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. lépés: A védett munkafüzet feltöltése
Feltöltse a helyi Excel fájlt az Aspose Cloud storage-ba. Az SDK közvetlenül streameli a fájlt, elkerülve a teljes fájl memóriában tartását.
using (var fileStream = File.OpenRead(localInputPath))
{
var uploadResult = await cellsApi.UploadFileAsync(remoteFilePath, fileStream);
}
3. lépés: A munkafüzet információinak lekérése és munkalap kiválasztása
Feltöltés után kérje le a munkafüzet metaadatait a munkalapok listájának megszerzéséhez. Ez a példa az első lapot választja, de megadhat bármilyen nevet.
var workbookResponse = await cellsApi.GetWorkbookAsync(remoteFileName, folder: remoteFolder);
string sheetName = workbookResponse.Workbook.Worksheets[0].Name;
4. lépés: Munkalap védelmének feloldása
Hívja meg az UnprotectWorksheetAsync metódust, átadva a munkalap nevét és a jelszót (vagy null, ha nincs jelszó beállítva). Ez a Aspose.Cells cloud .NET unprotect worksheet művelet lényege.
string password = "myPassword"; // replace with actual password or set to null
var unprotectResponse = await cellsApi.UnprotectWorksheetAsync(remoteFileName, sheetName, password, remoteFolder);
5. lépés: A frissített munkafüzet letöltése
Végül töltse le a módosított munkafüzetet vissza a helyi gépére, hogy ellenőrizze, a védelem eltávolításra került.
var downloadStream = await cellsApi.DownloadFileAsync(remoteFilePath);
using (var outputStream = File.Create(localOutputPath))
{
await downloadStream.CopyToAsync(outputStream);
}
Ezek a lépések bemutatják a teljes Aspose.Cells cloud .NET munkalap védelmének feloldása munkafolyamatot, a hitelesítéstől a fájl lekéréséig.
Teljesen működő példa az Aspose.Cells Cloud .NET munkalap védelmének feloldásához
Az alábbi kód egyetlen konzolalkalmazásban mutatja be a teljes folyamatot. Aszinkron/await-et használ a nem blokkoló I/O-hoz, és bemutatja a legjobb gyakorlatokat, például a hibák ellenőrzését minden API hívás után.
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}'.");
}
}
}
Megjegyzés: Ez a kódrészlet bemutatja az alapvető funkciókat. Mielőtt a projektjében használná, győződjön meg arról, hogy frissíti az összes fájlútvonalat és konfigurációs értéket, hogy megfeleljen a tényleges környezetének, ellenőrizze, hogy minden szükséges függőség megfelelően telepítve van-e, és alaposan tesztelje a fejlesztői környezetben. Ha problémába ütközik, kérjük, tekintse meg a hivatalos dokumentációt vagy vegye fel a kapcsolatot a támogatási csapattal segítségért.
Védett Excel munkalap feloldása cURL és a REST API segítségével
Ha nem szeretne C# kódot írni, ugyanazt az eredményt elérheti egyszerű HTTP hívásokkal. Az alábbiakban a szükséges cURL parancsok találhatók.
- Szerezzen hozzáférési tokent
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Töltsd fel a védett munkafüzetet
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-T "ProtectedWorkbook.xlsx"
- A munkalap védelmének feloldása
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"
- A védtelen munkafüzet letöltése
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "UnprotectedWorkbook.xlsx"
Ezek a parancsok ugyanazt a Aspose.Cells cloud .NET unprotect worksheet műveletet hajtják végre a REST interfész használatával. További részletekért tekintse meg a hivatalos API dokumentációt.
A munkalap védelmének feloldásának teljesítményének optimalizálása
- Használja újra a
CellsApipéldányt – új kliens létrehozása minden kéréshez többletterhet jelent. Tartson egyetlen példányt az alkalmazás teljes élettartama alatt. - Fájlok streamelése a teljes memóriába betöltés helyett – az SDK
UploadFileAsyncésDownloadFileAsyncmetódusai már streameket használnak, ami csökkenti a memória terhelését nagy munkafüzetek esetén. - Csoportos védetlemelt hívások – ha sok munkalapot kell feloldani, egyszer kérje le a munkalapok listáját, és iteráljon a
UnprotectWorksheetAsyncfelett anélkül, hogy minden alkalommal újra lekérdezné a munkafüzetet. - Futtassa az aszinkron metódusokat blokkolás nélkül – az
awaithasználata lehetővé teszi, hogy a szál más feladatokat végezzen, amíg a felhőművelet befejeződik, ezáltal javítva az általános áteresztőképességet.
Összegzés
A Aspose.Cells cloud .NET unprotect worksheet képesség lehetővé teszi, hogy programozottan eltávolítsa a védelem a Excel munkalapokról, megkönnyítve az integrálást automatizált adatcsővezetékekbe. A fenti lépések követésével hitelesíthet, feltölthet, feloldhatja a védelmet, és letöltheti a munkafüzeteket akár a .NET SDK-val, akár közvetlen REST hívásokkal. Ne feledje, hogy a termelési használathoz megfelelő licencet szerezzen be; a termék értékelése során elindulhat egy ideiglenes licenc oldal segítségével. További felfedezéshez tekintse meg a Aspose.Cells Cloud SDK for .NET dokumentációt, és kísérletezzen más munkalap‑kezelési funkciókkal.
Gyakran Ismételt Kérdések
-
Az Aspose.Cells cloud .NET unprotect worksheet hogyan kezeli a jelszóval védett munkalapokat?
Ha a helyes jelszót adja meg azUnprotectWorksheetAsynchívásban, az API eltávolítja a védelmet. Helytelen vagy hiányzó jelszó esetén hibaüzenet érkezik. -
Feloldhatom a védett Excel munkalapot az Aspose.Cells .NET használatával kód írása nélkül?
Igen. Ugyanezt a műveletet elvégezhetjük a REST API-n keresztül cURL vagy bármely HTTP kliens használatával, ahogyan a cikk cURL szakaszában látható. -
Milyen licenc szükséges az Aspose.Cells Cloud SDK for .NET termeléshez?
A termelési környezetben kereskedelmi licenc szükséges. Ideiglenes licencet szerezhet a temporary license page oldalról a tesztelés során. -
Van mód arra, hogy egyszerre több munkalapot védjünk fel egy munkafüzetben?
AGetWorkbookAsyncsegítségével lekérdezheted a munkalapok listáját, és minden néven végigiterálva meghívhatod aUnprotectWorksheetAsync-t minden egyes lapra. Ez a megközelítés programozottan működik az SDK-val.