LookupColumn 要素 (ビュー)
適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
Column 要素と同様に機能しますが、Lookup フィールドに言及するときだけ有効です。 Lookup フィールドに対する Column 要素と LookupColumn 要素の唯一の相違は、LookupColumn は外部リストから列の未加工値を取得し、Column はローカル リストの列の未加工値を取得することです。
<LookupColumn
HTMLEncode = "TRUE" | "FALSE" IncludeVersions = "TRUE" | "FALSE"
Name = "Text"
ShowField = "Text"
StripWS = "TRUE" | "FALSE"
URLEncode = "TRUE" | "FALSE"
URLEncodeAsURL = "TRUE" | "FALSE">
</LookupColumn>
要素と属性
以下のセクションで、属性、子要素、親要素について説明します。
属性
属性 | 説明 |
---|---|
Htmlencode |
省略可能 なブール値。 TRUE で、ブラウザにテキストとして表示されるように埋め込み文字を変換します。 つまり、HTML タグと混同する可能性がある文字はエンティティに変換されます。 |
IncludeVersions |
省略可能 なブール値。 |
名前 |
必須の Text。 ルックアップ列の名前を指定します。 ID を指定することで、LookupColumn 要素をフィールド外でコンテキストをレンダリングするために使用できるようにします。 |
ShowField |
オプションの Text。 Lookup フィールドから参照されるリストに表示されるフィールドを指定します。 この属性を指定しない場合、既定では、Title フィールドに含まれる値が表示されます。 |
StripWS |
省略可能 なブール値。 要素から返される値の先頭および末尾にある空白を削除する場合は、TRUE を設定します。 |
URLEncode |
省略可能 なブール値。 空白 などの特殊文字を引用符で囲まれた UTF-8 形式に変換する場合は TRUE (文字 %c3%ab ë など)。 |
URLEncodeAsURL |
省略可能 なブール値。 URLEncode と同様ですが、エンコードする文字列が URL のパス コンポーネントであり、スラッシュ (/ ) をエンコードしないことを指定する場合は TRUE です。 |
子要素
None
親要素
多数
Occurrences
- 最小 : 0
- 最大 : 制約なし (Expr1、Expr2、および UrlBaseName 内では 1)
注釈
LookupTitle という名前のルックアップ フィールドの場合、お知らせリストのアイテム 1 のタイトルを指し示す場合は、<LookupColumn Name="LookupTitle"/>
"SharePoint Foundation の概要!" をレンダリングし、"<Column Name="LookupTitle"/>
1" をレンダリングします。
その結果、Lookup フィールドにかかわるほとんどの状況で、Column 要素の代わりに、LookupColumn 要素を使用します。 Column 要素を使用する唯一の機会は、ターゲット リストのアイテム ID の未加工参照が必要な場合で、ターゲット アイテムへの独自のリンクを構築する場合などです。
例
以下の例では、LookupColumn 要素を使用して、サーバー上のページ用の完全な URL を作成するために使用される値を返します。
<HTML><![CDATA[ <a href=" ]]></HTML>
<HttpHost URLEncodeAsURL="TRUE" />
<LookupColumn URLEncodeAsURL="TRUE" />
<HTML><![CDATA[ "> ]]></HTML>