Contexto global.FillPropertyValues

Contexto global

FillPropertyValues

Disponible desde la versión 8.0.

Sintaxis:

FillPropertyValues(<Receptor>, <Fuente>, <ListaDePropiedades>, <ExcluirPropiedades>)

Parámetros:

<Receptor> (obligatorio)

Tipo: Arbitrario.
Una variable que tomará sus valores de las propiedades correspondientes de la <Fuente>.
Importante! El valor de este parámetro no puede ser de los siguientes tipos: Undefined, Null, Number, String, Date y Boolean.

<Fuente> (obligatorio)

Tipo: Arbitrario.
Los valores de las propiedades de este objeto se utilizarán para establecer las propiedades correspondientes del <Receptor>.
Importante! El valor de este parámetro no puede ser de los siguientes tipos: Undefined, Null, Number, String, Date y Boolean.

<ListaDePropiedades> (opcional)

Tipo: String.
Lista de nombres de propiedades separados por comas que se deben completar en <Fuente> y <Receptor>.
Si no se especifican propiedades, se copian solo las que están presentes tanto en <Fuente> como en <Receptor>.
Si se especifican propiedades, deben estar presentes en ambos objetos.
Si la propiedad especificada no está presente tanto en <Fuente> como en <Receptor>, se generará una excepción.
El parámetro se ignora si se establece <Fuente>.

<ExcluirPropiedades> (opcional)

Tipo: String.
Lista de nombres de propiedades separados por comas que se deben excluir de la copia en <Receptor>.
Si el <Receptor> contiene la propiedad con el nombre especificado en las propiedades excluidas, el valor de esta propiedad no se copiará. Y si el <Receptor> no contiene la propiedad especificada en las propiedades excluidas, se generará una excepción.

Descripción:

Copia los valores de las propiedades de <Fuente> a las propiedades de <Objetivo>. Las propiedades se asignan por sus nombres:

  • Si se especifican propiedades, el parámetro <ExcluirPropiedades> se ignora.
  • Si no se especifican propiedades ( <ListaDePropiedades> es Undefined) y se especifica el parámetro <ExcluirPropiedades>, se copian todas las propiedades, excepto las que se enumeran en el parámetro <ExcluirPropiedades>. Si una de las propiedades de la lista <ExcluirPropiedades> no se puede encontrar en <Fuente> o <Objetivo>, se genera una excepción en tiempo de ejecución.

Disponibilidad:

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

Nota:

En la versión Version8_3_8 o en un modo de compatibilidad anterior, la propiedad Template del documento de hoja de cálculo no se copiará.

Disponible desde:

Disponible desde la versión 8.0.

Descripción cambiada en la versión 8.3.20.