Arbeta med att ta bort kalkylblad i en Excel-arbetsbok
När ett program genererar eller modifierar Excel-filer dynamiskt kan du behöva ta bort kalkylblad som inte längre behövs – till exempel tillfälliga rapporter, platshållarkalkylblad eller inaktuella data. Aspose.Cells Cloud API gör det enkelt att ta bort ett enskilt kalkylblad eller flera kalkylblad i en enda förfrågan.
API-referens
| Objekt | Detaljer |
|---|---|
| HTTP-metod | DELETE |
| ** Slutpunkt** | /cells/{fileName}/worksheets |
| Sökvägsparametrar | fileName – namn på Excel-filen (obligatoriskt) |
| Frågeparametrar | sheetName – namn på det kalkylblad som ska tas bort (valfritt, för enskild borttagning) folder – källmapp i lagring (valfritt) storage – lagringsnamn (valfritt) |
| Förfrågningsbrödtext | Ingen |
| Lyckat svar | 200 OK – kalkylblad(en) har tagits bort framgångsrikt. Returnerar ett JSON-objekt med åtgärdens status. |
| Felaktiga svar | 400 Bad Request – ogiltiga parametrar 401 Unauthorized – autentisering misslyckades 404 Not Found – fil eller kalkylblad hittades inte 500 Internal Server Error – serverproblem |
Förfrågan
För att ta bort ett eller flera kalkylblad skickar du en DELETE-förfrågan till ovanstående slutpunkt, inklusive den obligatoriska fileName-parametern och valfritt sheetName-frågeparametern för borttagning av ett enskilt kalkylblad. När sheetName utelämnas tas alla kalkylblad i arbetsboken bort.
Parametrar
fileName(sträng, obligatoriskt): Namn på Excel-filen, inklusive filtillägg.sheetName(sträng, valfritt): Specifikt kalkylbladsnamn som ska tas bort. Om utelämnat tar API:t bort alla kalkylblad.folder(sträng, valfritt): Sökväg till mappen som innehåller filen i lagringen.storage(sträng, valfritt): Namn på Aspose Cloud-lagring som ska användas.
Svar
- 200 OK – Exempel på JSON:
{ "code": 200, "status": "OK", "message": "Kalkylblad(en) har tagits bort framgångsrikt." } - 400 Bad Request – Ogiltiga förfrågningsparametrar.
- 401 Unauthorized – Autentiseringstoken saknas eller är ogiltig.
- 404 Not Found – Angiven fil eller kalkylblad finns inte.
- 500 Internal Server Error – Oväntat serverfel.
Exempel
Nedan finns korta kodstycken som visar hur du anropar borttagningsändpunkten med tre populära språk.
C#-exempel
using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Client;
using Aspose.Cells.Cloud.SDK.Model;
var api = new CellsApi("client_id", "client_secret");
var fileName = "Sample.xlsx";
var sheetName = "TempSheet";
try
{
var response = api.DeleteWorksheet(fileName, sheetName);
Console.WriteLine($"Status: {response.Status}");
}
catch (Exception ex)
{
Console.WriteLine($"Fel: {ex.Message}");
}
Java-exempel
import com.aspose.cloud.cells.api.CellsApi;
import com.aspose.cloud.cells.model.ResponseMessage;
public class DeleteWorksheetDemo {
public static void main(String[] args) throws Exception {
CellsApi api = new CellsApi("client_id", "client_secret");
String fileName = "Sample.xlsx";
String sheetName = "TempSheet";
try {
ResponseMessage response = api.deleteWorksheet(fileName, sheetName, null, null);
System.out.println("Status: " + response.getStatus());
} catch (Exception e) {
System.err.println("Fel: " + e.getMessage());
}
}
}
Python-exempel
from asposecellscloud import CellsApi, ApiException
api = CellsApi(client_id="client_id", client_secret="client_secret")
file_name = "Sample.xlsx"
sheet_name = "TempSheet"
try:
response = api.delete_worksheet(file_name, sheet_name)
print(f"Status: {response.status}")
except ApiException as e:
print(f"Fel: {e}")
Felhantering
- Kontrollera att autentiseringstoken är giltig innan du skickar förfrågan.
- Kontrollera svarsstatuskoden och hantera
400,401,404och500på lämpligt sätt. - Använd try-catch-block (eller motsvarande) för att fånga nätverks- eller SDK-fel.
Relaterade åtgärder
- Lägg till ett kalkylblad – Skapa ett nytt kalkylblad i en befintlig arbetsbok.
- Kopiera ett kalkylblad – duplicera ett befintligt kalkylblad.
- Byt namn på ett kalkylblad – ändra namnet på ett kalkylblad.
- Flytta ett kalkylblad – ändra ordningen på kalkylblad i en arbetsbok.