GetValueAsList

説明

FieldInfo に関連したフィールドの文字列値のリストを戻します。これは、MULTILINE_STRING フィールドなどの、複数の値を含むフィールドや、参照リスト タイプ (REFERENCE_LIST) の親/子制御に役立ちます。

このメソッドをスカラ フィールド (単一値を含むフィールド) に使用することは正しい方法です。スカラ フィールドに使用されると、このメソッドは配列内の 1 つのエレメントのみを戻します (フィールドが空でない場合。空の場合は空の Variant が戻されます)。

フィールドに複数の値を格納できるか判別するには、対応する FieldInfoGetType メソッドを呼び出します。フィールドのタイプが REFERENCE_LISTATTACHMENT_LIST、または JOURNAL の場合、フィールドには複数の値を格納できます。

注: タイプが ATTACHMENT_LISTJOURNAL のいずれかのフィールドは、プログラムで変更できません。

構文

VBScript

fieldInfo.GetValueAsList 

Perl

$fieldInfo->GetValueAsList(); 
識別子
説明
fieldInfo
FieldInfo オブジェクト。ユーザー データ レコードの 1 つのフィールドに関する情報が含まれています。
戻り値
Visual Basic の場合、Variant 配列が戻されます。Variant には、vbLF で分離された、値のリストが含まれます (スカラ フィールドの場合、1 エレメントの Variant 配列が戻されます)。フィールドに値が含まれていない場合、このメソッドから空の Variant が戻されます。

Perl の場合は、リスト内の値を含む文字列の配列への参照。

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) {

   # ...

   } 

フィードバック