XMLUPDATEGRAM( ) (Función)

  • Artículo

Refleja en un diagrama de actualización XML los cambios realizados en una tabla o cursor almacenados en búfer.

XMLUPDATEGRAM( [cAliasList [, nFlags]])

Devuelve

Cadena.

Parámetros

  • cAliasList
    Especifica una lista separada por comas de tablas o cursores abiertos, por nombre o por números de área de trabajo en cualquier combinación, que se incluirán en el diagrama de actualización. Si no se especifica ningún valor o se especifica una cadena vacía para cAliasList, Visual FoxPro utiliza todas las tablas y los cursores abiertos en la sesión de datos actual que contienen cambios almacenados en búfer.

  • nFlags
    Aditivo. Especifica si el archivo devuelto tiene formato.

    nFlag Bit Descripción del resultado
    0 0000 XML con formato UTF-8 (valor predeterminado)
    1 0001 XML sin formato (cadena continua)
    2 0010 Se escriben elementos vacíos, con elementos de apertura y de cierre (por ejemplo, <cc04><cc04/>).
    4 0100 Conserva los espacios en blanco de los campos.
    8 1000 Ajusta campos Memo en secciones CDATA.
    16 10000 Codificación de resultados
    32 100000 Codificación de resultados

    Nota   Cuando la codificación de resultados es UTF-8 (la predeterminada), la Declaración XML no contiene el atributo Encoding= (ningún atributo de codificación = UTF-8).

    Cuando la codificación de resultados predeterminada se establece en la Página de códigos del cursor o de la tabla, el atributo de codificación se escribe de acuerdo con la tabla siguiente.

    Nota   Los indicadores de codificación se establecen mediante la combinación de los bits 4 y 5 (0010000).

    Indicador de codificación Bits 4 y 5 Descripción
    +0 00 Windows 1252 (predeterminada).
    +16 01 El atributo de codificación de los resultados se establece en la página de códigos del cursor.
    +32 10 El atributo de codificación de los resultados se establece en UTF-8, sin conversión de caracteres.
    +48 11 El atributo de codificación de los resultados se establece en UTF-8; los datos de caracteres se traducen a UTF-8.

Observaciones

Para utilizar XMLUPDATEGRAM( ), debe ejecutar SET MULTILOCKS ON y habilitar el almacenamiento de tablas en búfer.

Un diagrama de actualización XML es una representación de las condiciones originales y finales de la parte modificada de una tabla o cursor Visual FoxPro. XMLUPDATEGRAM( ) devuelve una cadena de caracteres que contiene el propio diagrama de actualización. Por medio de otros procesos, es posible utilizar un diagrama de actualización para confirmar estos cambios en los datos representados por el documento de diagrama de actualización XML.

Para especificar la lista de campos clave, debe ejecutarse CursorSetProp( ) con una cláusula KeyFieldList contra cursores y tablas existentes antes de la ejecución de XMLUpdateGram( ). Si no se especifican campos clave, tanto la representación original como la final contendrán todos los campos de la tabla. Si se especifica uno o más campos clave, sólo estos campos aparecerán en la sección <before>. Utilice la función CursorSetProp( ) para evitar posibles errores generados por XMLUpdateGram( ) en tablas que contengan campos Memo o General.

Vea también

CursorToXML( ) (Función) | XMLTOCURSOR( ) (Función) | CURSORSETPROP( ) (Propiedad) | COMPROP( ) (Función)