Compartir a través de

XMLTOCURSOR( ) (Función)

  • Artículo

Convierte texto XML en un cursor o tabla de Visual FoxPro.

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

Devuelve

Numérico. El número de registros creados.

Parámetros

  • eExpression
    Especifica el texto XML o una expresión que producen datos XML válidos. Este parámetro puede ser una variable de memoria de Visual FoxPro, el contenido de un campo memo o el valor devuelto por una solicitud HTTP. También puede especificar el valor devuelto por una llamada a un método SOAP, XML de XMLDOM o una secuencia ADO. XMLCURSOR( ) genera un error si no se encuentra XMLSource o si el análisis de eExpression no produce datos XML válidos.
  • cXMLFile
    Nombre y, opcionalmente, ruta de un archivo físico XML que reside en el equipo local o tiene acceso a través de la red. Si no se especifica una ruta, Visual FoxPro busca el archivo XML en la ruta de FoxPro.
  • cCursorName
    Especifica el nombre del cursor que contendrá el resultado. Si no se especifica cCursorName, Visual FoxPro devuelve el resultado a XMLRESULT. El cursor se crea en el área de trabajo actual, a menos que ya se esté utilizando. En este caso, el cursor se escribe en un área de trabajo que no se esté utilizando.
  • nFlags
    Especifica cómo se controla XMLSource eExpression en XMLTOCURSOR( ) de acuerdo con la tabla siguiente:
    nFlag Bit Descripción
    4 0100 Conserva los espacios en blanco de los datos. Reemplaza el atributo xml:space de los datos XML.
    512 01000000000 El parámetro uno (XMLSource eExpression o cXMLFile) es una cadena que contiene el nombre y la ruta de un archivo de datos XML. El valor predeterminado de nFlag, 0, trata el parámetro uno como una cadena que contiene datos XML.
    1024 10000000000 NOCPTRANS: se crearán campos de tipo Character y Memo en el cursor resultante con la opción NOCPTRANS, y el texto o los valores xml de los elementos entrantes se insertarán en el campo de tipo Character o Memo, byte a byte y sin conversión.

Observaciones

Si ya se ha abierto un cursor con el mismo nombre que el cursor de resultado especificado por cCursorName (o el valor predeterminado XMLRESULT si cCursorName no se ha especificado), se cierra el cursor existente y se crea el nuevo cursor en la primera área de trabajo disponible.

Visual FoxPro interpreta archivos XML con o sin esquema. Si no se proporciona ningún esquema, Visual FoxPro hace dos pasadas por los datos XML. La estructura se determina durante la primera pasada; durante la segunda, se ejecuta la conversión. Visual FoxPro utiliza el esquema externo o interno para determinar la estructura del cursor o la tabla antes de hacer una pasada única por los datos XML.

Vea también

Visual FoxPro y XML | CursorToXML( ) (Función) | XML UpdateGram( ) (Función)