XML の処理を使用する

XML 処理を扱う

Aspose.Cells FOSS for C++ は、XLSX ファイルを構成する Open XML 部分を読み書きするための軽量な内部 XML レイヤーを使用します。XmlDocument、XmlElement、および XmlAttribute クラスがこのレイヤーのコアを形成します。

XML ドキュメントの読み込み

インメモリのドキュメントツリーに XML 文字列またはファイルを解析するには、XmlDocument::Load を使用します:

#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 の構築と保存

プログラムで XML ドキュメントを構築するには XmlDocument::Build を使用し、XmlDocument::SaveToUtf8 を使用してそれを UTF-8 文字列にシリアライズします:

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

要素の走査

XmlElementは、要素の値、子要素、属性への軽量ハンドルベースのアクセスを提供します。デフォルト構築された要素はIsNull() == trueを返し、これは安全なnullチェックとして使用できます：

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

属性の操作

XmlAttributeは要素上の属性名と値のペアへのアクセスを提供します。新しい属性を作成するにはXmlAttribute::MakeAttribute(name, value)を使用してください：

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

内部 XML マッパー

このライブラリは、専用のマッパークラスを使用して、インメモリのスプレッドシートモデルオブジェクトをXML表現に変換したり、逆に変換したりします。これらはシリアライズ層の内部で使用されます：

各マッパーはReadとWriteメソッドを公開します。これらはXlsxWorkbookSerializerによって内部的に呼び出され、アプリケーションコードで直接使用することは想定されていません。

エラー処理

XMLのパースエラーはXmlParsingExceptionをスローします。信頼できない、または不正なXMLを読み込む際はこの例外を捕捉してください：

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

ヒントとベストプラクティス

• 要素データにアクセスする前にXmlElement::IsNull()を確認してください — 存在しないパスの要素はnullハンドルを返します。
• デバッグや中間XML状態のログ記録のためにシリアライズされた文字列を取得するにはXmlDocument::SaveToUtf8()を使用します。
• アプリケーションコード内でマッパークラス（WorkbookXmlMapper、WorksheetXmlMapperなど）を直接インスタンス化しないでください — 代わりにWorkbook::SaveとWorkbook(filePath)を使用します。
• XmlParsingExceptionは不正なXMLでスローされます；外部XMLのロードは常にtry/catchブロックでラップしてください。

一般的な問題

API Reference の概要

参照

• Aspose.Cells for C++ — Enterprise Documentation