XDTODataObject.Add

XDTODataObject

Add

Disponible desde la versión 8.1.

Variante de sintaxis: Establecer un valor de una nueva propiedad personalizada

Sintaxis:

Add(<Formulario>, <NamespaceURI>, <LocalName>, <DataElement>, <TypeAssignment>)

Parámetros:

<Formulario> (requerido)

Tipo: XMLForm.
Formulario de presentación XML de una propiedad personalizada. Puede tener los valores Elemento o Atributo.

<NamespaceURI> (requerido)

Tipo: String.
URI de espacio de nombres de la presentación XML de la propiedad personalizada.

<LocalName> (requerido)

Tipo: String.
Nombre local de una propiedad personalizada.

<DataElement> (requerido)

Tipo: XDTODataValue, XDTODataObject.
Elemento de datos XDTO (valor u objeto) que es un valor de una propiedad personalizada.

<TypeAssignment> (opcional)

Tipo: XMLTypeAssignment.
Asigna un tipo de datos de una propiedad arbitraria al serializarla.
Valor predeterminado: Implicit.

Descripción de la variante del método:

El nombre de la propiedad se creará automáticamente, basado en el nombre local de la presentación XML de la propiedad. En caso de que ya exista una propiedad personalizada con el nombre recibido y, si se realizó una configuración de valor anterior de una propiedad personalizada para esta propiedad personalizada o para otra propiedad si hay una secuencia presente, la propiedad se enumerará con un límite superior ilimitado. De lo contrario, se iniciará una excepción. El tipo de propiedad creado siempre se establece como cualquier tipo de espacio de nombres de esquema XML.

Variante de sintaxis: Establecer un valor de una propiedad personalizada existente

Sintaxis:

Add(<Nombre>, <DataElement>, <TypeAssignment>)

Parámetros:

<Nombre> (requerido)

Tipo: String.
Nombre de una propiedad personalizada.

<DataElement> (requerido)

Tipo: XDTODataValue, XDTODataObject.
Elemento de datos XDTO (valor u objeto) que es un valor de una propiedad personalizada.

<TypeAssignment> (opcional)

Tipo: XMLTypeAssignment.
Asigna un tipo de datos de una propiedad arbitraria al serializarla.
Valor predeterminado: Implicit.

Descripción de la variante del método:

Si no existe una propiedad con el nombre especificado, se iniciará una excepción.
En caso de que se haya realizado una configuración anterior del valor de una propiedad personalizada para esta propiedad personalizada, o para otra propiedad si hay una secuencia presente, la propiedad se enumerará con un límite superior ilimitado.
De lo contrario, se iniciará una excepción.

Descripción:

Agrega un valor a una propiedad personalizada.

Disponibilidad:

Cliente ligero, cliente móvil, servidor, cliente grueso, conexión externa, aplicación móvil (cliente), aplicación móvil (servidor), servidor independiente móvil.

Nota:

El método solo se puede llamar para los tipos de objeto con la propiedad Open establecida, de lo contrario se iniciará una excepción.

Disponible desde:

Disponible desde la versión 8.1.

Descripción cambiada en la versión 8.3.25.