Freigeben über


XMLTOCURSOR( )-Funktion

Konvertiert XML-Text in einen Visual FoxPro-Cursor oder eine Visual FoxPro-Tabelle.

XMLTOCURSOR(XMLSource eExpression | cXMLFile [, cCursorName [, nFlags ]])

Rückgabetypen

Numerisch. Die Anzahl der erstellten Datensätze.

Parameter

  • eExpression
    Gibt den XML-Text oder einen Ausdruck an, der als gültige XML-Daten bewertet wird. Bei diesem Parameter kann es sich um eine Visual FoxPro-Speichervariable, um den Inhalt eines Memofeldes oder um den Rückgabewert einer HTTP-Anfrage handeln. Sie können auch einen Rückgabewert von einem SOAP-Methodenaufruf, XML von XMLDOM oder einen ADO-Stream angeben. XMLCURSOR( ) generiert einen Fehler wenn XMLSource nicht gefunden wird oder wenn eExpression nicht als gültige XML-Daten ausgewertet werden kann.
  • cXMLFile
    Gibt den Namen und optional den Pfad einer physischen XML-Datei an, die sich auf einem lokalen Computer oder im Netzwerk befindet. Wenn Sie keinen Pfad angeben, durchsucht Visual FoxPro den Visual FoxPro-Pfad nach der XML-Datei.
  • cCursorName
    Gibt den Namen des Cursors mit dem Ergebnis an. Wenn Sie für cCursorName keinen Wert angeben, gibt Visual FoxPro das Ergebnis in XMLRESULT zurück. Der Cursor wird im aktuellen Arbeitsbereich erstellt, sofern dieser nicht bereits verwendet wird. Andernfalls wird der Cursor in einen nicht belegten Arbeitsbereich geschrieben.
  • nFlags
    Gibt an, wie XMLSource eExpression in XMLTOCURSOR( ) behandelt wird, und zwar entsprechend der folgenden Tabelle:
    nFlag Bit Beschreibung
    4 0100 Beibehaltung von Leerschritten in den Daten. Setzt das xml:space-Attribut der XML-Daten außer Kraft.
    512 01000000000 Parameter eins (XMLSource eExpression oder cXMLFile) ist eine Zeichenfolge, die den Namen und Pfad einer XML-Datendatei enthält. Ist für nFlag der Standardwert 0 festgelegt, wird Parameter eins als Zeichenfolge behandelt, die XML-Daten enthält.
    1024 10000000000 NOCPTRANS – Zeichen- und Memofelder im resultierenden Cursor werden mit der Option NOCPTRANS erstellt. Der Text oder die XML-Werte in den eingehenden Elementen werden nicht umgewandelt und byteweise in das Zeichen- oder Memofeld eingefügt.

Hinweise

Wenn bereits ein Cursor geöffnet ist, der den gleichen Namen benutzt wie der Ausgabecursor, der mit cCursorName angegeben wird (oder mit dem Standardwert für XMLRESULT, wenn cCursorName nicht angegeben wurde), dann wird der vorhandene Cursor beendet und der neue Cursor im ersten verfügbaren Arbeitsbereich erstellt.

Visual FoxPro interpretiert XML-Dateien mit oder ohne Schema. Wird kein Schema angegeben, führt Visual FoxPro zwei Durchläufe durch die XML-Daten aus. Im ersten Durchlauf wird die Struktur festgestellt, im zweiten Durchlauf erfolgt dann die Konvertierung. Visual FoxPro verwendet entweder ein externes oder internes Schema, um den Cursor oder die Tabellenstruktur festzustellen, bevor ein Durchlauf durch die XML-Daten erfolgt.

Siehe auch

Visual FoxPro und XML | CursorToXML( )-Funktion | XMLUpdateGram( )-Funktion