Suchen und Ersetzen von Text in Excel-Dateien mithilfe der Aspose.Cells Cloud API

Textoperationen sind komplexe Prozesse für Excel-Dateien. Viele Faktoren tragen zu dieser Komplexität bei und sollten während der Verarbeitung berücksichtigt werden. Aspose.Cells Cloud bietet eine zuverlässige Möglichkeit, Text in einer Vielzahl von Tabellenkalkulationsformaten zu suchen und zu ersetzen.

Die Arbeit mit Text in Excel-Arbeitsmappen erfordert häufig das Auffinden spezifischer Zeichenfolgen und das Aktualisieren dieser über mehrere Arbeitsblätter hinweg. Die Aspose.Cells Cloud API vereinfacht diese Aufgabe durch eine einheitliche Such- und Ersetzungsoperation, die in allen unterstützten Tabellenkalkulationsformaten funktioniert.

Übersicht

Mit der Such- und Ersetzungsfunktion können Sie spezifische Zeichenfolgen in einer Arbeitsmappe oder einem bestimmten Arbeitsblatt suchen und durch neue Werte ersetzen. Der Vorgang funktioniert mit allen von Aspose.Cells Cloud unterstützten Formaten wie XLS, XLSX, XLSM, XLSB, ODS, CSV und weiteren. Mithilfe der Such- und Ersetzungsfunktion können Sie Daten schnell bereinigen, wiederholte Tippfehler korrigieren oder mithilfe von Massenbenennungskonventionen在整个 Arbeitsmappe anwenden.

Voraussetzungen

  • Ein aktiver Aspose.Cloud-Account mit gültiger Client‑Id und Client‑Secret.
  • Zugriffstoken, das über den OAuth 2.0-Authentifizierungsfluss erhalten wurde.
  • Die Zielarbeitsmappe muss im Aspose Cloud-Speicher gespeichert oder über eine öffentliche URL erreichbar sein.
  • Erforderliches SDK installiert (z. B. Aspose.Cells‑Cloud für .NET, Java oder Python).

API-Referenz

Methode: POST
Endpunkt

POST https://api.aspose.cloud/v3.0/cells/{fileName}/searchreplace
Parameter Typ Erforderlich Beschreibung
fileName string Ja Name der Arbeitsmappe (einschließlich Dateierweiterung).
folder string Nein Pfad zum Cloud-Speicherordner.
storage string Nein Speichername, sofern nicht der Standard verwendet wird.
sheetName string Nein Name des spezifischen Arbeitsblatts; falls weggelassen, gilt der Vorgang für die gesamte Mappe.
searchString string Ja Zu suchender Text.
replaceString string Ja Text, durch den die gefundenen Vorkommen ersetzt werden sollen.
ignoreCase boolean Nein Auf true setzen, um eine groß-/kleinschreibungunabhängige Suche durchzuführen.
matchWholeCell boolean Nein Auf true setzen, um nur ganze Zellübereinstimmungen zu ersetzen.

Header

  • Authorization: Bearer {access_token}
  • Content-Type: application/json

Anforderungstext (JSON)

{
  "searchString": "AlterWert",
  "replaceString": "NeuerWert",
  "ignoreCase": false,
  "matchWholeCell": false,
  "sheetName": "Tabelle1"
}

Erfolgreiche Antwort (JSON)

{
  "status": "OK",
  "replacedCount": 3,
  "updatedFileUrl": "https://api.aspose.cloud/v3.0/storage/file/updatedWorkbook.xlsx"
}

Unterstützte Formate

Format Erweiterung
Excel-Arbeitsmappe .xls, .xlsx, .xlsm, .xlsb
OpenDocument Tabellenkalkulation .ods
CSV .csv
Weitere (wie von Aspose.Cells unterstützt) —

Codebeispiele

Im Folgenden finden Sie minimale Beispiele für drei gängige SDKs. Ersetzen Sie {clientId}, {clientSecret} und andere Platzhalter durch Ihre tatsächlichen Werte. Diese Beispiele zeigen, wie Sie einen Such- und Ersetzungsvorgang programmgesteuert durchführen.

Fehlerbehandlung und Randfälle

HTTP-Code Bedeutung Empfohlene Maßnahme
400 Bad Request – fehlende oder ungültige Parameter Überprüfen Sie erforderliche Felder und Datentypen.
401 Unauthorized – ungültiges oder abgelaufenes Token Aktualisieren Sie den Zugriffstoken.
404 Not Found – Arbeitsmappe oder Arbeitsblatt nicht vorhanden Überprüfen Sie Dateiname, Ordnerpfad und sheetName.
415 Unsupported Media Type – ungültiges Dateiformat Stellen Sie sicher, dass die hochgeladene Datei ein unterstütztes Excel- oder CSV-Format hat.
202 Accepted – Anfrage zur Verarbeitung akzeptiert Pollen Sie den Vorgangsstatus, falls asynchrone Verarbeitung verwendet wird.
204 No Content – Vorgang erfolgreich ohne Antwortbody Die Ersetzung wurde angewendet; es werden keine weiteren Daten zurückgegeben.
500 Internal Server Error – unerwarteter Fehler Wiederholen Sie den Vorgang nach einer kurzen Verzögerung; kontaktieren Sie den Aspose-Support, falls das Problem bestehen bleibt.

Hinweise:

  • Große Arbeitsmappen können die Anforderungsgrößenbeschränkungen überschreiten; erwägen Sie daher, die Datei zuerst in den Cloud-Speicher hochzuladen.
  • Wenn ignoreCase auf true gesetzt ist, beachten Sie, dass länderspezifische Groß-/Kleinschreibungsumordnungen die Ergebnisse beeinflussen können.
  • Die Verwendung von matchWholeCell bei Formeln ersetzt keine Teilübereinstimmungen innerhalb des Formeltextes.

Suchen und Ersetzen in Excel-Dateien

Excel-Dateien zusammenführen und teilen Daten in Excel-Dateien importieren und Daten aus Excel-Dateien exportieren