Share via

FieldRef 要素 (ContentType)

  • [アーティクル]

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

このコンテンツ タイプで参照する列を指定します。

定義

<FieldRef
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  Customization="Text"
  DefaultValue="Text"
  Description="Text"
  DisplayName="Text"
  Format="Text"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  FromBaseType="TRUE" | "FALSE"
  Hidden="TRUE" | "FALSE" | "orResource"
  ID="Text"
  Locked="TRUE" | "FALSE"
  Name="Text"
  Node="Text"
  NumLines="Integer"
  PIAttribute="Text"
  PITarget="Text"
  PrimaryPIAttribute="Text"
  PrimaryPITarge="Text"
  ReadOnly="TRUE" | "FALSE"
  ReadOnlyClient="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  Sealed="TRUE" | "FALSE"
  ShowInDisplayForm="TRUE" | "FALSE"
  ShowInEditForm="TRUE" | "FALSE"
  ShowInFileDlg="TRUE" | "FALSE"
  ShowInListSettings="TRUE" | "FALSE"
  ShowInNewForm="TRUE" | "FALSE"
  Sortable="TRUE" | "FALSE">
</FieldRef>

要素と属性

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

属性

属性 説明
集計

Node 属性を使用して、値のコレクションを返す XPath 式を指定する場合は、返された値セットに対するアクションを指定する Aggregation 属性も含めることができます。

このアクションには、集計関数またはコレクション内の特定の要素の表示を指定できます。

以下のいずれかの値を使用できます。

  • 合計

  • count

  • 平均

  • min

  • max

  • マージ

  • plaintext ノードテキストコンテンツをプレーンテキストに変換します。

  • first プロパティの昇格と降格をコレクション内の最初の要素に適用します。

  • last プロパティの昇格と、コレクション内の最後の要素への降格を適用します。

XML ドキュメントでのプロパティの昇格と降格に Node、PIAttribute、PITarget、PrimaryPIAttribute、PrimaryPITarget の各属性を使用する方法の詳細については、「コンテンツ タイプを使用して XML ドキュメントのプロパティを指定する」を参照してください。
カスタマイズ

オプションの Text。 ユーザー設定フィールドのプロパティを定義する、Collaborative Application Markup Language (CAML) の文字列。
DefaultValue

使用されていません。
説明

オプションの Text。 列の説明が指定されている場合に、リストの編集フォームに表示される説明を提供します。 既定では、SharePoint Foundation の列には説明がありません。
DisplayName

必須の Text。 列の表示名。 最大文字数は 255 文字です。

この属性の値は、フィールドをテーブル ビューで表示したときには列の見出しとして使用され、フィールドをフォームで表示したときにはフォーム ラベルとして使用されます。 表示名を、フィールド自体で定義されている名前と異なる値に変更するには、DisplayName 属性を使用します。
Format

オプションの Text。 数値に使用する書式を指定します。

日時の列では、以下の値を指定できます。

  • DateOnly 日付部分のみを表示 (および編集を許可) します (編集されたすべての値の時刻部分は午前 12 時に設定されます)。

  • DateTime 日付と時刻の両方を表示および編集します (既定値)。

  • ISO8601 UTC: YYYY-MM-DDTHH:MM:SSZ に変換された ISO8601 時刻形式の日付と時刻を表示します。

    これは、Microsoft Office システムのドキュメント プロパティに使用される形式と、新規フォームと編集フォームとサーバーの間の Microsoft SharePoint Foundation で使用される標準のインターチェンジ形式に使用される形式です。

  • ISO8601Basic 8601 日付/時刻形式の省略形を使用します。YYYYMMDDTHHMMSSZ。

    これは、vCard/iCal で使用される形式です。

Choice フィールドでは、この属性を Dropdown (既定) に設定すると、編集オプションがドロップダウン リストで提供され、RadioButtons に設定すると、オプションが一連のラジオ ボタンで提供されます。

URL フィールドの場合、この属性は ハイパーリンク (既定値) に設定できます。URL は通常 <A> のタグとして表示されます。また、 URL は として <IMG SRC="URL" ALT="Description">表示される Image に設定できます。
フィルター処理可能

省略可能 なブール値。 TRUE の場合、列はフィルタ可能として定義されます。
FilterableNoRecurrence

省略可能 なブール値。 TRUE の場合、列はフィルタ可能で値の繰り返しなしとして定義されます。
FromBaseType

省略可能 なブール値。 この属性は、 Sealed 属性を優先して非推奨になりました。
Hidden

省略可能 なブール値。 TRUE の場合、フィールドはユーザー インターフェイスにまったく表示されません。 ReadOnly を TRUE に設定すると、フィールドは新規フォームまたは編集フォームに表示されず、ビューに含めることもできます。

この属性を含まない場合、SharePoint Foundation は、属性が FALSE に設定されているかのように列を扱います。
ID

必須の Text。 この FieldRef 要素が参照する列のフィールド ID を指定します。 フィールド ID は GUID の文字列表現で、波かっこが含まれます。 値では大文字と小文字が区別されます。

組み込みフィールドの ID は、次のパスにあるファイル fieldswss.xml にあります。
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\FEATURES\fields
ロック済み 使用されていません。
名前

オプションの Text。 列の名前。 これは列の内部的な名前であり、フィールド定義が有効な間は決して変更されません。 リスト内の一連のフィールドで一意である必要があります。
ノード

オプションの Text。 列の値を含むドキュメント内の XML ノードを指定します。 XML ドキュメントでのプロパティの昇格および降格のために使用されます。

NodeNodePIAttributePIAttributePITargetPITargetPrimary PIAttributePrimary PIAttributePrimaryPITargetPrimaryPITargetコンテンツ タイプを使用して XML ドキュメントのプロパティを指定するUsing Content Types to Specify XML Document Properties
NumLines

オプションの Integer。 編集中に TEXTAREA ブロックに行数を表示することを推奨します。 これは単なるクライアント UI ヒントです。編集できるテキストの行数に制限はありません。
PIAttribute オプションの Text。 PITarget 属性で指定されたドキュメント処理命令で列の値として使用する属性を指定します。 XML ドキュメントでのプロパティの昇格および降格のために使用されます。

PIAttribute 属性を指定する場合、PITarget 属性も指定する必要があります。

NodeNodePIAttributePIAttributePITargetPITargetPrimary PIAttributePrimary PIAttributePrimaryPITargetPrimaryPITargetコンテンツ タイプを使用して XML ドキュメントのプロパティを指定するUsing Content Types to Specify XML Document Properties
PITarget

オプションの Text。 列の値をこのコンテンツ タイプのドキュメントに格納するドキュメント処理命令を指定します。 XML ドキュメントでのプロパティの昇格および降格のために使用されます。

PIAttribute 属性を指定する場合、PITarget 属性も指定する必要があります。

NodeNodePIAttributePIAttributePITargetPITargetPrimary PIAttributePrimary PIAttributePrimaryPITargetPrimaryPITargetコンテンツ タイプを使用して XML ドキュメントのプロパティを指定するUsing Content Types to Specify XML Document Properties
PrimaryPIAttribute

オプションの Text。 PrimaryPITarget 属性で指定されたドキュメント処理命令で列の値として使用する代替属性を指定します。

PrimaryPIAttribute 属性を指定する場合、PrimaryPITarget 属性も指定する必要があります。 指定した場合、SharePoint Foundation では、 PITarget 属性と PIAttribute 属性で指定された値の前にこれらの値が使用されます。

XML ドキュメントでのプロパティの昇格および降格のために使用されます。

NodeNodePIAttributePIAttributePITargetPITargetPrimary PIAttributePrimary PIAttributePrimaryPITargetPrimaryPITargetコンテンツ タイプを使用して XML ドキュメントのプロパティを指定するUsing Content Types to Specify XML Document Properties
PrimaryPITarget

オプションの Text。 列の値をこのコンテンツ タイプのドキュメントに格納する代替のドキュメント処理命令を指定します。

PrimaryPIAttribute 属性を指定する場合、PrimaryPITarget 属性も指定する必要があります。 指定した場合、SharePoint Foundation では、 PITarget 属性と PIAttribute 属性で指定された値の前にこれらの値が使用されます。

NodeNodePIAttributePIAttributePITargetPITargetPrimary PIAttributePrimary PIAttributePrimaryPITargetPrimaryPITargetコンテンツ タイプを使用して XML ドキュメントのプロパティを指定するUsing Content Types to Specify XML Document Properties
ReadOnly

省略可能 なブール値。 TRUE の場合、フィールドは新規フォームまたは編集フォームに表示されませんが、ビューに含めることができます。 Hidden 属性を TRUE に設定すると、フィールドは UI で完全に非表示になります。

この属性を含まない場合、SharePoint Foundation は、属性が FALSE に設定されているかのように列を扱います。
必須

必須 のブール値。 TRUE の場合、このコンテンツ タイプを使用して作成されたアイテムを保存する前に、フィールドに値が割り当てられている必要があります。

フォーム投稿に空のフィールド値が指定されている場合は、標準の必須フィールド テキストまたは明示的に指定されたメッセージ (つまり、ErrorText> タグを使用) <がエラー フォームに表示されます。 この検証はクライアントによってのみ処理されます (データベースでは、すべてのユーザー定義フィールドに対して常に NULL が許可されます)。
密封

省略可能 なブール値。 TRUE の場合、列はシール済みとして定義されます。 SharePoint Foundation ユーザー インターフェイスまたはオブジェクト モデルを使用して、シールされた列を編集することはできません。この属性を含まない場合、SharePoint Foundation は、属性が FALSE に設定されているかのように列を扱います。
ShowInDisplayForm

省略可能 なブール値。 TRUE の場合、このコンテンツ タイプのアイテムの列が表示フォームに表示されます。
ShowInEditForm

省略可能 なブール値。 TRUE の場合、[アイテムの編集] ページにフィールドが表示されます。
ShowinFileDlg

省略可能 なブール値。 TRUE の場合、このコンテンツ タイプのアイテムの列がファイル ダイアログ ボックス表示されます。
ShowInListSettings

省略可能 なブール値。 FALSE の場合、表示モードが New に設定されているときは、フィールドが Fields 列挙に表示されません。 この設定のフィールドは、リストの既定の [新しいアイテム] ページに表示されません。
ShowInNewForm

省略可能 なブール値。 TRUE の場合、このコンテンツ タイプのアイテムの列が新規作成フォームに表示されます。
並べ替え可能か

省略可能 なブール値。 フィールドの値を並べ替えることができる場合は TRUE。

子要素

None

親要素

Occurrence

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

注釈

FieldRef 要素は、サイト レベルまたはリスト レベルで別に定義された列への参照です。 フィールド参照では、以下のような列プロパティのサブセットを上書きすることができます。

  • 表示名
  • XML の昇格属性と降格属性
  • フィールドが読み取り専用、必須、または非表示

フィールド参照でこれらのプロパティを変更すると、そのフィールド参照を含む特定のコンテンツ タイプに適用される際のプロパティだけが変更されます。

重要

FieldRef 要素が、同じ要素マニフェストで定義されているフィールドを参照している場合でも、ID、Name、DisplayName、および Required 属性が必ず必要です。

例

次の例では、2 つの FieldRef 要素を使用して、コンテンツ タイプに含める列を指定しています。

<FieldRefs>
  <!--  Built-in Title field -->
  <FieldRef ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Name="Title" DisplayName="Item" Required="TRUE" Sealed="TRUE"/>
  <!--  Custom CostCenter field -->
  <FieldRef ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}" Name="CostCenter" DisplayName="Department" Required="TRUE"/>
</FieldRefs>

関連項目