GetValueAsList

Description

Devuelve una lista de valores de serie para el campo asociado a FieldInfo. Es útil para los campos que contienen más de un valor, incluidos los tipos de campo MULTILINE_STRING y los controles padre/hijo para tipos de lista de referencia (REFERENCE_LIST).

Se permite utilizar este método para un campo escalar (es decir, un campo que contenga un solo valor). Cuando se utiliza en un campo escalar, este método sólo devuelve un elemento en la matriz (a menos que el campo esté vacío, en cuyo caso, se devuelve un Empty Variant).

Para determinar si un campo puede contener varios valores, llame al método GetType del objeto FieldInfo correspondiente. Si el tipo del campo es REFERENCE_LIST, ATTACHMENT_LIST o JOURNAL, el campo puede contener varios valores.

Nota: Los campos cuyo tipo es ATTACHMENT_LIST o JOURNAL no se pueden modificar de modo programático.

Sintaxis

VBScript

fieldInfo.GetValueAsList 

Perl

$fieldInfo->GetValueAsList(); 
Identificador
Description
fieldInfo
Un objeto FieldInfo que contiene información sobre un campo de un registro de datos de usuario.
Valor de retorno
Para Visual Basic, devuelve un valor Variant Array. El valor Variant contiene la lista de valores, separados por vbLF (para campos escalares, devuelve Variant Array de 1 elemento). Si el campo no contiene ningún valor, este método devuelve un Empty Variant.

Para Perl, una referencia a una matriz de series que contiene los valores de la lista.

Ejemplos

VBScript

MyList = MyField.GetValueAsList

if not IsEmpty (MyList) then

   for each listItem in MyList

   '...

   next

end if

' You can separate the single variant that is returned into an array of 
' string list elements by using the Split function:

av = GetFieldValue("multiline_string_field").GetValueAsList

if not IsEmpty(av) then

  array = Split(Cstr(av(0)),vbLF)

  u = UBound(array)

  for i = 0 to u

    ' ...

  next

end if

Perl

$asgs = $entity->GetFieldValue("Assignments")->GetValueAsList();

foreach my $asg (@$asgs) {

   # ...

   } 

Comentarios