XML-Puffer
Ein XML-Puffer bietet effizienten Speicher im Arbeitsspeicher für beliebige XML-Daten.
Verwenden Sie zum Lesen von Daten aus einem XML-Puffer einen XML Reader- und rufen Sie WsSetInputToBuffer- mit dem XML-Puffer auf. Der Leser wird am Anfang des Dokuments positioniert.
Verwenden Sie zum Einfügen von Daten in einen Puffer ein XML Writer- und rufen Sie WsSetOutputToBuffer- mit dem XML-Puffer auf. Der Autor wird am Ende des Dokuments positioniert.
Nachdem ein Reader auf einen XML-Puffer festgelegt wurde, können WsMoveReader- zusätzlich zu allen XML-Reader-APIs verwendet werden, um durch das Dokument zu navigieren. WsGetReaderPosition- und WsSetReaderPosition- kann auch verwendet werden, um eine Position im Dokument aufzuzeichnen und später dorthin zurückzukehren.
Nachdem ein Writer auf einen XML-Puffer festgelegt wurde, können WsMoveWriter- zusätzlich zu allen XML Writer-APIs verwendet werden, um durch das Dokument zu navigieren. WsGetWriterPosition- und WsSetWriterPosition- kann auch verwendet werden, um eine Position im Dokument aufzuzeichnen und später dorthin zurückzukehren. Der Writer fügt immer Daten vor dem Knoten ein, an den er positioniert ist.
Knoten können aus dem XML-Puffer gelöscht werden, indem die Position des Knotens mithilfe WsGetReaderPosition oder WsGetWriterPosition abgerufen und dann WsRemoveNode mit dieser Position aufgerufen wird. Bei Elementen löscht dies das Element, alle untergeordneten Elemente einschließlich des übereinstimmenden Endelements.
Eine Position wird durch den Wert WS_XML_NODE_POSITIONdargestellt. Positionen sind spezifisch für einen bestimmten XML-Puffer und sind nur gültig, solange der XML-Puffer gültig ist.
Die folgenden Enumerationen werden mit XML-Puffern verwendet:
Die folgenden Funktionen werden mit XML-Puffern verwendet:
Das folgende Handle wird mit XML-Puffern verwendet:
Die folgenden Strukturen werden mit XML-Puffern verwendet: