Το ξεκλείδωμα ενός προστατευμένου φύλλου εργασίας Excel είναι συχνή απαίτηση όταν αυτοματοποιείται η επεξεργασία δεδομένων ή ετοιμάζονται αναφορές για τελικούς χρήστες. Aspose.Cells Cloud SDK for .NET παρέχει ένα ισχυρό API που σας επιτρέπει να αφαιρέσετε την προστασία του φύλλου εργασίας χωρίς χειροκίνητη παρέμβαση. Σε αυτόν τον οδηγό θα μάθετε πώς να διαμορφώσετε το SDK, να ανεβάσετε ένα βιβλίο εργασίας, να καλέσετε τη λειτουργία unprotect και να ανακτήσετε το ξεκλείδωτο αρχείο, όλα με έτοιμο‑για‑εκτέλεση κώδικα και παραδείγματα cURL.
Ρύθμιση Aspose.Cells Cloud SDK για .NET
Πριν ξεκινήσετε, βεβαιωθείτε ότι έχετε τα εξής:
- Εγκατεστημένο .NET 6.0 ή νεότερο.
- Ένας λογαριασμός Aspose Cloud με Client Id και Client Secret.
- Πρόσβαση σε τερματικό ή IDE όπου μπορείτε να εκτελέσετε εντολές .NET.
Εγκαταστήστε το SDK μέσω του NuGet:
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 storage. Η επόμενη ενότητα περνάει από κάθε βήμα προγραμματισμού.
Οδηγός βήμα προς βήμα για Aspose.Cells Cloud .NET Αποπροστασία φύλλου εργασίας
Βήμα 1: Φόρτωση Διαπιστευτηρίων και Δημιουργία του API Client
Για να ξεκινήσετε, ανακτήστε το client ID και το secret από το περιβάλλον και δημιουργήστε ένα αντικείμενο 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 Αποπροστασία φύλλου εργασίας
Ο παρακάτω κώδικας δείχνει ολόκληρη τη διαδικασία σε μια ενιαία εφαρμογή κονσόλας. Χρησιμοποιεί async/await για μη‑αποκλειστικό I/O και επιδεικνύει βέλτιστες πρακτικές όπως ο έλεγχος σφαλμάτων μετά από κάθε κλήση 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}'.");
}
}
}
Σημείωση: Αυτό το παράδειγμα κώδικα δείχνει τη βασική λειτουργικότητα. Πριν το χρησιμοποιήσετε στο έργο σας, βεβαιωθείτε ότι έχετε ενημερώσει τυχόν διαδρομές αρχείων και τιμές ρυθμίσεων ώστε να ταιριάζουν με το πραγματικό σας περιβάλλον, επαληθεύστε ότι όλες οι απαιτούμενες εξαρτήσεις είναι σωστά εγκατεστημένες και δοκιμάστε εκτενώς στο περιβάλλον ανάπτυξής σας. Εάν αντιμετωπίσετε προβλήματα, παρακαλούμε ανατρέξτε στην επίσημη τεκμηρίωση ή επικοινωνήστε με την ομάδα υποστήριξης για βοήθεια.
Ξεκλείδωμα προστατευμένου φύλλου Excel με cURL και το REST API
Αν προτιμάτε να μην γράψετε κώδικα 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"
Αυτές οι εντολές εκτελούν την ίδια Aspose.Cells cloud .NET unprotect worksheet λειτουργία χρησιμοποιώντας τη διασύνδεση REST. Για περισσότερες λεπτομέρειες, δείτε την επίσημη τεκμηρίωση API.
Βελτιστοποίηση της απόδοσης αποπροστασίας φύλλου εργασίας
- Επαναχρησιμοποίηση της παρουσίας
CellsApi- η δημιουργία νέου πελάτη για κάθε αίτηση προσθέτει επιπλέον κόστος. Διατηρήστε μία μόνο παρουσία για τη διάρκεια της εφαρμογής σας. - Μετάδοση αρχείων μέσω ροής αντί για πλήρη φόρτωση στη μνήμη - οι μέθοδοι
UploadFileAsyncκαιDownloadFileAsyncτου SDK χρησιμοποιούν ήδη ροές, κάτι που μειώνει την πίεση στη μνήμη για μεγάλα βιβλία εργασίας. - Ομαδικές κλήσεις αποπροστασίας - εάν χρειάζεται να ξεκλειδώσετε πολλά φύλλα εργασίας, ανακτήστε τη λίστα των φύλλων μία φορά και επαναλάβετε το
UnprotectWorksheetAsyncχωρίς να ερωτάτε ξανά το βιβλίο εργασίας κάθε φορά. - Εκτέλεση των ασύγχρονων μεθόδων χωρίς μπλοκάρισμα - η χρήση του
awaitεπιτρέπει στο νήμα να εκτελεί άλλες εργασίες ενώ η λειτουργία στο cloud ολοκληρώνεται, βελτιώνοντας τη συνολική απόδοση.
Συνοψίζοντας
Η δυνατότητα Aspose.Cells cloud .NET unprotect worksheet σας επιτρέπει να αφαιρέσετε προγραμματιστικά την προστασία από φύλλα Excel, καθιστώντας εύκολη την ενσωμάτωση σε αυτοματοποιημένες ροές δεδομένων. Ακολουθώντας τα παραπάνω βήματα, μπορείτε να πιστοποιηθείτε, να ανεβάσετε, να αφαιρέσετε την προστασία και να κατεβάσετε βιβλία εργασίας χρησιμοποιώντας είτε το .NET SDK είτε άμεσες κλήσεις REST. Θυμηθείτε να αποκτήσετε την κατάλληλη άδεια για χρήση σε παραγωγή· μπορείτε να ξεκινήσετε με μια temporary license page ενώ αξιολογείτε το προϊόν. Για περαιτέρω εξερεύνηση, ελέγξτε την τεκμηρίωση του Aspose.Cells Cloud SDK for .NET και πειραματιστείτε με άλλες δυνατότητες διαχείρισης φύλλων εργασίας.
Συχνές ερωτήσεις
-
Πώς η λειτουργία unprotect worksheet του Aspose.Cells cloud .NET διαχειρίζεται φύλλα προστατευμένα με κωδικό;
Όταν παρέχετε τον σωστό κωδικό στην κλήσηUnprotectWorksheetAsync, το API αφαιρεί την προστασία. Ένας εσφαλμένος ή ελλιπής κωδικός οδηγεί σε απάντηση σφάλματος. -
Μπορώ να ξεκλειδώσω ένα προστατευμένο φύλλο Excel χρησιμοποιώντας Aspose.Cells .NET χωρίς να γράψω κώδικα;
Ναι. Η ίδια λειτουργία μπορεί να εκτελεστεί μέσω του REST API χρησιμοποιώντας cURL ή οποιονδήποτε HTTP client, όπως φαίνεται στην ενότητα cURL αυτού του άρθρου. -
Τι άδεια απαιτείται για το Aspose.Cells Cloud SDK for .NET στην παραγωγή;
Απαιτείται εμπορική άδεια για τις παραγωγικές αναπτύξεις. Μπορείτε να αποκτήσετε προσωρινή άδεια από τη σελίδα προσωρινής άδειας κατά τη διάρκεια των δοκιμών. -
Υπάρχει τρόπος να αποπροστατεύσετε μαζικά πολλά φύλλα εργασίας σε ένα βιβλίο εργασίας;
Μπορείτε να ανακτήσετε τη λίστα των φύλλων εργασίας μεGetWorkbookAsyncκαι να επαναλάβετε για κάθε όνομα, καλώντας τοUnprotectWorksheetAsyncγια κάθε φύλλο. Αυτή η προσέγγιση λειτουργεί προγραμματιστικά με το SDK.