Freigeben über


XMLUPDATEGRAM( )-Funktion

Spiegelt Änderungen wider, die in einer zwischengespeicherten Tabelle oder in einem Cursor für ein XML-Updategram vorgenommen wurden.

XMLUPDATEGRAM( [cAliasList [, nFlags]])

Rückgabetypen

Zeichenfolge.

Parameter

  • cAliasList
    Gibt eine durch Kommas getrennte Liste geöffneter Tabellen oder Cursor an, die das Updategram enthalten soll, und zwar in beliebiger Kombination nach dem Namen oder der Arbeitsbereichnummer. Wenn Sie für cAliasList keinen Wert oder eine leere Zeichenfolge angeben, verwendet Visual FoxPro alle geöffneten Tabellen und Cursor in der aktuellen Datensitzung, die zwischengespeicherte Änderungen enthalten.

  • nFlags
    Kumulierend. Gibt an, ob die zurückgegebene Datei formatiert ist.

    nFlag Bit Ausgabebeschreibung
    0 0000 UTF-8-formatierte XML-Datei (Standard)
    1 0001 Nicht formatierte XML-Datei (fortlaufende Zeichenfolge)
    2 0010 Leere Elemente, die mit öffnenden und schließenden Elementen geschrieben sind (z. B. <cc04><cc04/>)
    4 0100 Beibehaltung von Leerschritten in den Feldern
    8 1000 Memofelder in CDATA-Abschnitten
    16 10000 Ausgabecodierung
    32 100000 Ausgabecodierung

    Anmerkung   Wenn für die Ausgabecodierung UTF-8 (Standardeinstellung) festgelegt ist, dann enthält die XML-Deklaration kein Attribut vom Typ Encoding= (kein Codierungsattribut = UTF-8).

    Wenn für die Ausgabecodierung die Standardeinstellung der Codepage des Cursors oder der Tabelle festgelegt ist, dann wird das Attribut für die Codierung entsprechend der folgenden Tabelle geschrieben.

    Anmerkung   Codierungsflags werden durch Kombination von Bit 4 und 5 (0010000) festgelegt.

    Codierungsflag Bit 4 und 5 Beschreibung
    +0 00 Windows 1252. (Standard)
    +16 01 Das Attribut für die Ausgabecodierung wird auf die Codepage des Cursors gesetzt
    +32 10 Das Attribut für die Ausgabecodierung wird auf UTF-8 gesetzt - keine Zeichenübersetzung
    +48 11 Das Attribut für die Ausgabecodierung wird auf UTF-8 gesetzt - Doppelbyte-Zeichen werden in UTF-8 übersetzt

Hinweise

Sie müssen MULTILOCKS (SET MULTILOCKS ON) und die Zwischenspeicherung von Tabellen aktivieren, wenn Sie XMLUPDATEGRAM( ) verwenden möchten.

Ein XML-Updategram ist eine Darstellung des Zustands eines geänderten Abschnitts vor und nach einer Änderung in einer Visual FoxPro-Tabelle oder in einem Cursor. XMLUPDATEGRAM( ) gibt eine Zeichenfolge zurück, die das Updategram enthält. Mit Hilfe zusätzlicher Prozesse können Sie ein Updategram verwenden, um die Änderungen für die Daten zu übernehmen, die vom XML-Updategram-Dokument dargestellt werden.

Vor dem Ausgeben von XMLUpdateGram( ) sollten Sie die Liste der Schlüsselfelder angeben, indem Sie die CursorSetProp( )-Funktion mit einer KeyFieldList-Klausel für vorhandene Cursor und Tabellen ausführen. Wenn Sie keine Schlüsselfelder angeben, sind in den Darstellungen für den Zustand vor und nach einer Änderung alle Felder der Tabelle enthalten. Wenn Sie eines oder mehrere Schlüsselfelder angeben, werden nur diese Felder im Abschnitt <before> angezeigt. Verwenden Sie die CursorSetProp( )-Funktion, um mögliche Fehler zu vermeiden, die von XMLUpdateGram( ) in Tabellen generiert werden, die Memo- oder Objektfelder enthalten.

Siehe auch

CursorToXML( )-Funktion | XMLTOCURSOR( )-Funktion | CURSORSETPROP( )-Funktion | COMPROP( )-Funktion