ForEach 要素 (ビュー)ForEach element (View)

に適用されます: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint オンライン |SharePoint Server 2013Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

現在のリストに定義されているビューまたはフィールドのコレクションを列挙するための基本的なメカニズムを指定します。Provides a basic mechanism for enumerating a collection of views or fields defined in the current list.

<ForEach
  Select = "Text">
</ForEach>

要素と属性Elements and attributes

以下のセクションで、属性、子要素、親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute 説明Description
SelectSelect
必須の Text。列挙する名前空間。Required Text. The namespace to enumerate.

子要素Child elements

多数Numerous

親要素Parent elements

多数Numerous

出現回数Occurrences

  • 最小 : 0Minimum: 0
  • 最大 : 制約なしMaximum: Unbounded

備考Remarks

Select 属性の値は、次のようにさまざまなスキーマ ファイルによって異なります。The value of the Select attribute varies in the different schema files:

  • CHOICES/CHOICE選択肢フィールドの内部。CHOICES/CHOICE inside a Choice field. 大文字と小文字とスラッシュ (/) がないことに注意してください。Note capitalization and the lack of a leading forward slash (/). この例では、 ForEach要素 (つまり、フィールドの要素) 内のフィールドまたはフィールドを列挙する別のForEach要素内に入れ子にする必要があります。In this case, the ForEach element must be nested inside another ForEach element that enumerates Fields/Field (in other words, inside a Fields element). フィールドの列挙体の現在のポイントは、選択肢のフィールドにする必要があります。The current point in the Fields enumeration must be a Choice field.

  • /FIELDS/Field現在のリスト内のすべてのフィールドを列挙しています。/FIELDS/Field for enumerating all the fields in the current list.

  • /FORMS/Form(ビューに非常に似ています) の特定のリストのすべてのフォームを列挙します。/FORMS/Form for enumerating all the forms for a particular list (very similar to views).

  • /LISTTEMPLATES/ListTemplate(お知らせ、タスク、連絡先、イベント、およびなど) のOnet.xmlファイルで指定されたすべてのサーバーでサポートされているリストの定義を列挙します。/LISTTEMPLATES/ListTemplate for enumerating all the server-supported list definitions specified in the Onet.xml file (for announcements, tasks, contacts, events, and so on).

  • /DOCUMENTTEMPLATES/DocumentTemplateすべてのサーバーでサポートされているドキュメント ライブラリ テンプレート ファイル (Microsoft Excel ワークシート、Word 文書など) を列挙しています。/DOCUMENTTEMPLATES/DocumentTemplate for enumerating all the server-supported document library template files (Microsoft Excel worksheet, Microsoft Word document, etc.).

ForEach 要素の本体は、コレクション内の各ビューまたは各フィールドごとに 1 回レンダリングされます。Property 要素を使用して、ビューまたはフィールドの個々のプロパティを抽出できます。The body of the ForEach element is rendered once for each view or field in the collection. The Property element can be used to extract individual properties of the view or field.

また、ForEach 要素を使用して、単一のフィールドまたはビューを参照することもできます。この作業を実行するには、目的のフィールドまたはビューの名前で変数を設定し、MatchVar 属性を使用して、その変数を参照する必要があります。The ForEach element can also be used to reference a single field or view. To do so, a variable must be set with the name of the desired field or view; the MatchVar attribute is used to reference that variable.

Example

次は、ForEach 要素を使用して、ドロップダウン リスト ボックスを構築する例です。The following example uses the ForEach element to construct a drop-down list box.

<ForEach Select="CHOICES/CHOICE">
   <HTML>fld.AddChoice(</HTML>
   <ScriptQuote>
      <Property Select="."/>
   </ScriptQuote>
   <HTML>, </HTML>
   <ScriptQuote>
      <Property Select="Value"/>
   </ScriptQuote>
   <HTML>);</HTML>
</ForEach>