XML-feldolgozással való munka

XML-feldolgozással való munka

XML-feldolgozással való munka

Aspose.Cells FOSS for C++ uses a lightweight internal XML layer to read and write the Open XML parts that make up an XLSX file. The XmlDocument, XmlElement, és XmlAttribute Az osztályok képezik ennek a rétegnek a magját.


XML dokumentum betöltése

Használat XmlDocument::Load egy XML-hárc vagy fájl elemzése a memóriában lévő dokumentumfaban:

#include "aspose/cells_foss/XmlDocument.h"

using namespace Aspose::Cells_FOSS;

// Load from string content
XmlDocument doc;
doc.Load("<root><item key=\"a\">value</item></root>");

XML létrehozása és mentése

Használat XmlDocument::Build az XML-dokumentum programozással történő felépítése, és XmlDocument::SaveToUtf8 hogy visszaállítsuk a UTF-8 sztranghoz:

XmlDocument doc;
// Build the document structure
auto xml = doc.SaveToUtf8();

A végigjáró elemek

XmlElement A program könnyű kézzel hozzáférhet az elem értékekhez, a gyermekeknek és az atribútumoknak. Az alapértelmezett elemek visszatérnek. IsNull() == true, amely biztonságos null-ellenőrzésként használható:

XmlElement root = doc.GetRootElement();
if (!root.IsNull()) {
    // Traverse children via GetAttributes
    auto attrs = root.GetAttributes();
}

Attribútumokkal való munka

XmlAttribute hozzáférést biztosít egy elem attribútumneve és értékpárjaihoz. Use XmlAttribute::MakeAttribute(name, value) új attribútumok létrehozása:

XmlAttribute attr = XmlAttribute::MakeAttribute("key", "value");
bool isNull = attr.IsNull();

Belső XML-térképező

A könyvtár a saját mapper osztályokat használja az emlék-táblás modell objektumok XML reprezentációkba és azokból történő átalakítására. Ezek a sorozatosítási rétegben belül vannak:

Mapper osztályFelelősség
WorkbookXmlMapperOlvassa és írja a munkafüzet kapcsolati részét
WorksheetXmlMapperOlvassa és írja az egyes munkalap XML-részeit
StylesheetXmlMapperOlvassa és írja a stílusokat.
SharedStringTableXmlMapperOlvassa és írja a megosztott szalagok táblázatát

Minden térképező feltárja Read és a Write Ezeket belsőleg úgy hívják, hogy XlsxWorkbookSerializer és nem a kérelmek kódjában való közvetlen felhasználásra szánt.


Hibakezelés

XML-elemzés hibái . XmlParsingException.Ez a kivétel az nem megbízható vagy hibás XML betöltésekor:

try {
    doc.Load(xmlContent);
} catch (const XmlParsingException& ex) {
    // Handle parse error
}

Tippek és legjobb gyakorlatok

  • A csekk. XmlElement::IsNull() az elemadatokhoz való hozzáférés előtt a hiányzó útvonalak elemeinek nullás foglalása.
  • Használat XmlDocument::SaveToUtf8() hogy egy sorozatos szalagot kapjon a középső XML állapot hibaelhárításához vagy naplózásához.
  • Ne instanciáljon mapper osztályokat (WorkbookXmlMapper, WorksheetXmlMapper, stb.) közvetlenül a kérelmek kódjában használatban. Workbook::Save és a következők: Workbook(filePath) - De nem.
  • XmlParsingException a rosszul formált XML-re kerül; mindig csomagolja be a külső XML terheléseket egy try/catch blokkba.

Általános kérdések

A kérdésOkokMegjavítani.
IsNull() true-t ad visszaNem talált elem a várható útvonalonEllenőrizni az XML-szerkezetet a átjárás előtt
XmlParsingException terhelveNem megfelelő XML vagy UTF-8-nem megfelelőA bevitel XML-eit hitelesítse a továbbítás előtt Load
A mapper kimenete eltér a bemenettől.Művészeti mutáció mentés előttBiztosítani, hogy minden modellváltozás megtörtént a hívás előtt. Save

API-referencia összefoglaló

Az osztály/módszerLeírás
XmlDocument::Load(content)XML-tárgy elemzés
XmlDocument::Build()A dokumentum programozásra való alkalmazása
XmlDocument::SaveToUtf8()A dokumentum UTF-8-es szalagra történő szériálása
XmlElement::IsNull()Ellenőrizze, hogy a elem kezelője érvényes-e.
XmlElement::GetValue()Szerezd meg az elem szövegtartalmát!
XmlElement::GetAttributes()Szerezd meg az atribútumok gyűjteményét.
XmlAttribute::IsNull()Ellenőrizze, hogy a tulajdonság kezelője érvényes-e.
XmlAttribute::MakeAttribute(name, value)Új attribútumkezelő létrehozása
XmlParsingExceptionEltűnt a hibás XML-bevitelre
WorksheetXmlMapperA belső XML olvasás/írás munkalap
WorkbookXmlMapperBelső munkafüzet XML olvasás/írás

Lásd még:

 Magyar