ForEach 要素 (ビュー)

  • [アーティクル]

適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

現在のリストに定義されているビューまたはフィールドのコレクションを列挙するための基本的なメカニズムを指定します。

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

要素と属性

以下のセクションで、属性、子要素、親要素について説明します。

属性

属性 説明
Select
必須の Text。 列挙する名前空間。

子要素

多数

親要素

多数

Occurrences

  • 最小 : 0
  • 最大: 制約なし

注釈

Select 属性の値は、次のようにさまざまなスキーマ ファイルによって異なります。

  • CHOICES/CHOICE選択肢フィールド内。 大文字と小文字が正しく使われていること、および先頭のスラッシュ (/) がないことに注意してください。 ここでは、ForEach 要素は、Fields/Field を列挙する別の ForEach 要素内 (言い換えると、Fields 要素内) に入れ子にされている必要があります。 Fields 列挙の現在のポイントは、Choice フィールドでなければなりません。

  • /FIELDS/Field 現在のリスト内のすべてのフィールドを列挙します。

  • /FORMS/Form 特定のリストのすべてのフォームを列挙する場合 (ビューと非常によく似ています)。

  • /LISTTEMPLATES/ListTemplateOnet.xml ファイルで指定されたすべてのサーバーでサポートされているすべてのリスト定義を列挙する場合 (アナウンス、タスク、連絡先、イベントなど)。

  • /DOCUMENTTEMPLATES/DocumentTemplate サーバーでサポートされているすべてのドキュメント ライブラリ テンプレート ファイル (Microsoft Excel ワークシート、Microsoft Word 文書など) を列挙します。

ForEach 要素の本体は、コレクション内の各ビューまたは各フィールドごとに 1 回レンダリングされます。 Property 要素を使用して、ビューまたはフィールドの個々のプロパティを抽出できます。

また、ForEach 要素を使用して、単一のフィールドまたはビューを参照することもできます。 この作業を実行するには、目的のフィールドまたはビューの名前で変数を設定し、MatchVar 属性を使用して、その変数を参照する必要があります。

例

次は、ForEach 要素を使用して、ドロップダウン リスト ボックスを構築する例です。

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