ProjectedFields 要素 (ビュー)

  • [アーティクル]

最終更新日: 2015年3月9日

適用対象: SharePoint Foundation 2010

この記事の内容
属性
子要素
親要素
出現回数

クエリで 1 つ以上の他のリストが結合されている場合に、ビューに含めることができる結合リスト内のフィールドを指定します。

<ProjectedFields>   
  <Field ... />  
  <Field ... />
</ProjectedFields>

属性

なし

子要素

Field

注意

Field 子要素の数には上限があります。その数は、リストで許容される最大フィールド数と、リスト内に既に存在するフィールド数との差異として定義されます。

親要素

View

出現回数

注意

View 要素に ProjectedFields 要素を含めるには、View 要素に、1 つ以上の Join 子要素を持つ Joins 要素が含まれている必要があります。ただし、SPQuery.ProjectedFields プロパティの値を形成する (したがって、View 要素の子ではない) ProjectedFields 要素を使用して、Joins 要素のない暗黙的結合をサポートできます。Joins 要素を使用することをお勧めします。明示的な Join 要素を常に使用することで、ソリューションと Microsoft SharePoint Foundation の今後のリリースとの互換性が最大限確保されます。ProjectedFields 要素を使用する暗黙的な結合の詳細については、「結合と予測のリストを作成する」を参照してください。

最小: 0

最大: 1

コメント

結合リストからのフィールドが ProjectedFields で表現されない場合、そのフィールドを ViewFields 要素に含めることはできません。

例

以下の例は、クエリで返される結果に別のフィールドを追加する方法を示しています。List 属性の値は、外部リストのエイリアスです。このエイリアスは、Join 要素 (ビュー) で定義されます。ShowField 属性は、外部フィールドの内部名に設定する必要があります。

Type 属性は、Field 要素で通常行われているようにフィールドのデータ型を示すことはありません。Field 要素が ProjectedFields 要素の子の場合、Type は、単に、Join 要素 (ProjectedFields 要素の依存先の Joins 要素内) が、リスト間の既存の検索関係に基づいているかどうかを示すのみです。SharePoint Foundation 2010 では、すべての結合は既存の検索関係に基づく必要があるため、Type は、値 "Lookup" を常に持ちます。フィールドが ProjectedFields 要素の子の場合、フィールドの実際のデータ型は示されません。ただし、フィールドのデータ型は問題になります。ProjectedFields 要素に含めることができるのは、フィールドの以下の型のみなためです。

  • Calculated (プレーン テキストとして処理)

  • ContentTypeId

  • Counter

  • Currency

  • DateTime

  • Guid

  • Integer

  • Note (1 行のみ)

  • Number

  • Text

<ProjectedFields>
  <Field
    Name=’CustomerCity’
    Type=’Lookup’
    List=’customerCities’
    ShowField=’Title’ />
</ProjectedFields>

子の Field 要素に List 属性ではなく FieldRef 属性が含まれる ProjectedFields 要素の例については、「結合と予測のリストを作成する」を参照してください。