View 要素 (リスト)
適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
リスト定義 (Schema.xml) では、Microsoft SharePoint Foundation に基づいて Web サイト内のリストのビューを定義します。各リストには多数のビューを含めることができます。
注:
SharePoint Foundation 2010 では XSLT を使用してリスト ビューを定義し、下位互換性のために ビュー スキーマ が維持されます。 XSLT リスト ビューの詳細については、「リスト ビュー」を参照してください。
<View
AggregateView = "TRUE" | "FALSE"
BaseViewID = "Integer"
ContentTypeID = "Text" CssStyleSheet = "Text"
DefaultView = "TRUE" | "FALSE"
DefaultViewForContentType = "TRUE" | "FALSE"
DisplayName = "Text"
FailIfEmpty = "TRUE" | "FALSE"
FileDialog = "TRUE" | "FALSE"
FPModified = "TRUE" | "FALSE"
FreeForm = "TRUE" | "FALSE"
Hidden = "TRUE" | "FALSE"
ImageUrl = "Text"
IncludeRootFolder = "TRUE" | "FALSE"
List = "Integer" | "Text"
MobileDefaultView = "TRUE" | "FALSE" MobileItemLimit = "Integer" MobileUrl = "Text"
MobileView = "TRUE" | "FALSE"
ModerationType = "Text"
Name = "Text"
OrderedView = "TRUE" | "FALSE"
PageType = "Text"
Path = "Text"
ReadOnly = "TRUE" | "FALSE"
RecurrenceRowset = "TRUE" | "FALSE"
ReqAuth = "TRUE" | "FALSE"
RequiresClientIntegration = "TRUE" | "FALSE"
RowLimit = "Integer"
Scope = "Text"
SetupPath = "Text"
ShowHeaderUI = "TRUE" | "FALSE" TabularView = "TRUE" | "FALSE"
TargetId = "Text"
TargetType = "List" | "ContentType"
Threaded = "TRUE" | "FALSE"
ToolbarTemplate = "Text"
Type = "HTML" | "Chart" | "Pivot"
Url = "Text"
WebPartOrder = "Integer"
WebPartZoneID = "Text">
</View>
要素と属性
以下のセクションで、属性、子要素、親要素について説明します。
属性
| 属性 | 説明 |
|---|---|
| AggregateView |
省略可能 なブール値。 ビューが XML フォーム ライブラリで使用されるフォームの結合ビューであることを指定する場合は TRUE。 既定では、XML フォーム ライブラリには、最初は非表示であるフォームの結合ビューがあります。 XML エディタを使用して XML Form Properties (XFP) ファイルを、エディタで使用されるテンプレートと共にライブラリの Forms ディレクトリに発行すると、AggregateView 属性によってフォームの結合ビューが識別されます。 リスト テンプレートまたはライブラリの定義でデータの結合がサポートされるかどうかによって、このビューの表示と非表示を切り替えることができます。 |
| BaseViewID |
オプションの Integer。 基本ビューの ID を指定します。 |
| ContentTypeID |
オプションの Text。 ビューが関連付けられているコンテンツ タイプの ID を指定します。 |
| CssStyleSheet |
オプションの Text。 |
| DefaultView |
省略可能 なブール値。 ビューが既定のビューであることを指定する場合は TRUE。 |
| DefaultViewForContentType |
省略可能 なブール値。 ビューがコンテンツ タイプの既定のビューであることを指定する場合は TRUE。 |
| DisplayName |
オプションの Text。 サイド リンク バーに表示されるビューの名前を指定します。 |
| FailIfEmpty |
省略可能 なブール値。 ビューがアイテムを返さないときに、ViewEmpty 要素をレンダリングする代わりに、空白のページおよび HTTP エラー コードを返す場合は TRUE。 クライアント アプリケーションからのプログラムによるビューの操作で使用され、クライアント アプリケーションでビューが空であるかどうかを検出するためにドキュメントを解析する必要がなくなります。 |
| FileDialog |
省略可能 なブール値。 SharePoint Foundation のコンテキスト内で使用されるアプリケーションのファイル ダイアログ ボックスにビューを表示し、出力 HTML を解析してリストの内容を決定することを指定する場合は TRUE。 |
| FPModified |
省略可能 なブール値。 Web ページ エディターでの編集によってビューが変更され、SharePoint Foundation ユーザー インターフェイス (UI) によってビューがカスタマイズできなくなった場合は TRUE。 |
| 自由形 状 |
省略可能 なブール値。 フィールドをレンダリングするときに特定のフィールド型の代替フィールド形式を指定する場合は TRUE。 特に、この属性は数字の列の整列に影響し、テーブル以外のユーザー設定ビューで便利です。 |
| Hidden |
省略可能 なブール値。 ビューを非表示にする場合は TRUE。 |
| ImageUrl |
オプションの Text。 リスト ビューのタイトル領域に表示されるイメージのサーバー相対 URL を指定します (例: /_layouts/images/pgrpicon.png)。 |
| IncludeRootFolder |
省略可能 なブール値。 ルート フォルダをリスト ビューに返すことを指定する場合は TRUE です。 |
| List |
オプションの Integer または Text。 リストの種類を指定します。 この値は、リストのテンプレートの ID (整数)、またはサイトで準備されたリストの URL (文字列) のどちらかにすることができます。 Integer ではリストが特定されない場合があるため (たとえば、お知らせリストが 2 つある場合に、List=104 を指定したときなど)、Text を使用することをお勧めします。 |
| MobileDefaultView |
省略可能 なブール値。 標準の SharePoint リスト ビューが既定のモバイル ビューであることを指定する場合は TRUE。 既定のモバイル ビューとして指定できるのは、リストごとに 1 つのビューだけです。 |
| MobileItemLimit |
オプションの Integer。 |
| MobileUrl |
オプションの Text。 |
| MobileView |
省略可能 なブール値。 標準の SharePoint リスト ビューがモバイル ビューでもあることを指定する場合は TRUE。 この属性は、予定表、データシート、またはガント ビューには適用されません。 |
| ModerationType |
オプションの Text。 コンテンツの承認の種類を指定します。 これは HideUnapproved、 Contributor、Moderator のいずれかです。 HideUnapproved ビューでは、未承認の下書きアイテムは、アイテムの読み取りアクセス許可のみを持つユーザーから非表示になります。 [共同作成者] ビューには、現在のユーザーの保留中のアイテムと拒否されたアイテムが表示されます。 Moderator ビューには、マネージド リストのアクセス許可を持ち、すべてのユーザーの保留中および拒否されたアイテムが表示されているユーザーのみがアクセスできます。 |
| 名前 |
オプションの Text。 ビューに指定された名前。は、UI で別の名前付きビューを選択したり、 ルックアップ フィールドのフィルターを指定するときに名前付きビューを参照したりするために使用されます。 |
| OrderedView |
省略可能 なブール値。 ビューが順序付けられていることを指定する場合は TRUE。 |
| PageType |
オプションの Text。 ビューが使用されるフォームの種類を指定します。 以下のいずれかの値を使用できます。 DEFAULTVIEW 既定のビュー。 DIALOGVIEW [ファイル] ダイアログ ボックス ビュー。 DISPLAYFORM リスト アイテムのフォームを表示します。 DISPLAYFORMDIALOG ファイル ダイアログ ボックスのフォームを表示します。 EDITFORM リスト アイテムのフォームを編集します。 EDITFORMDIALOG ファイル ダイアログ ボックスのフォームを編集します。 無効です 使用されていません。 MAXITEMS 使用されていません。 NEWFORM リスト アイテムの新しいフォーム。 NEWFORMDIALOG ファイル ダイアログ ボックスの新しいフォーム。 NORMALVIEW 標準ビュー。 SOLUTIONFORM ソリューション フォーム。 ビュー 既定のビューと標準ビューの両方を含むビュー。 |
| パス |
オプションの Text。 ビューのファイル名を指定します。 |
| ReadOnly |
省略可能 なブール値。 ビューを読み取り専用にする場合は TRUE。 |
| RecurrenceRowset |
省略可能 なブール値。 ビューで定期的なイベントを展開して、定期的なイベントの各インスタンスを表示する場合は TRUE。 既定値は FALSE です。 |
| ReqAuth |
省略可能 なブール値。 |
| RequiresClientIntegration |
省略可能 なブール値。 クライアント アプリケーションを起動する機能を使用する場合は TRUE。それ以外の場合、ユーザーはローカルでドキュメントを操作し、変更をアップロードする必要があります。 |
| RowLimit |
オプションの Integer。 HTML のビューの種類にのみ適用されます。 1 ページにレンダリングする最大行数を指定します。 行の制限値を超えた場合は、Next ボタンと Previous ボタンを使用して、返されたすべてのレコードセットを表示できます。 RowLimit が指定されていない場合、返される既定の行数は 50 です。 ビューの種類に None を指定すると、レコードセットのすべての行が 1 つのビューで返されます。 ビューがレンダリングされると、現在のビューがデータセットの行制限に達したかどうかに基づいて、レンダリング変数 ViewHasNextViewHasPrevと が TRUE または FALSE に設定されます。 これらの変数を、次の例のように、一連のページ定義内で使用して、ページに Next および Previous ボタンをレンダリングできます。XML<Switch> <Expr><GetVar Name="ViewHasPrev"/></Expr> <Case Value="TRUE"> <![CDATA[...Previous button defined here... ]]> </Case></Switch>変数 NextPageURL と PrevPageURL は、現在のディスプレイから前方または後方のページング コンテンツがある場合にも、非空白値に設定されます。 これらの変数を使用することによって、コンテンツの次のページにアクセスするための適切な URL が設定された Next および Previous ボタンを構築できます。 |
| スコープ |
オプションの Text。 ドキュメント ライブラリのビューの再帰的な範囲を指定します。 以下のいずれかの値を使用できます。 FilesOnly - 特定のフォルダのファイルのみを表示します。 Recursive - すべてのフォルダのすべてのファイルを表示します。 RecursiveAll - すべてのフォルダのすべてのファイルとすべてのサブフォルダを表示します。 この属性が設定されていない場合、ビューには特定のフォルダのファイルとサブフォルダのみが表示されます。 この属性の値は、SPView クラスの Scope プロパティに対応します。 |
| SetupPath |
オプションの Text。 ビューの .aspx ページを含むセットアップ ディレクトリ内のフォルダーへのサイト相対パスを指定します (例: pages\viewpage.aspx)。 |
| ShowHeaderUI |
省略可能 なブール値。 ヘッダー表示モードで使用されるすべての FieldRef 要素を、HTML で UI を装飾せずにレンダリングする場合は、FALSE。 つまり、このモードが設定されている場合、UI では、列のヘッダーにハイパーリンクとして並べ替えやフィルタは提供されません。 既定値は TRUE です。 |
| TabularView |
省略可能 なブール値。 |
| Targetid |
オプションの Text。 |
| TargetType |
オプションの Text。 List、ContentType のいずれかの値を使用できます。 |
| スレッド |
省略可能 なブール値。 ビューで内部のグループ化を適用する場合は TRUE。 組み込みのスレッド列 (リストについて存在していると仮定) に基づいてスレッド ビューが構築されます。 ビューは、このフィールドを 2 番目の並べ替え列として並べ替えられます。 ビュー内の他の列の並べ替えやグループ化が指定されている場合、そのルールはスレッド列の並べ替え順の前に適用されます。 結果として、トピックごとにグループ化されたすべてのディスカッションを収集でき、コレクションの下にメッセージ スレッドを表示できます。 TRUE の場合、RowLimit 要素は、スレッド形式のディスカッション掲示板リスト ビューで使用されたときには異なる意味を持ちます。 返すアイテムの数を指定する代わりに、返すディスカッション スレッドの数を指定し、この場合 1 つのスレッドが 1 つ以上のアイテムで構成される場合があります。 Thread 属性を TRUE に設定することに加えて、スレッド ビューをスレッド ID で並べ替える必要があります。それ以外の場合、この行制限の動作は有効になりません。 |
| ToolbarTemplate |
オプションの Text。 ビューのツール バーに使用される事前定義済みのツール バー テンプレートの名前を指定します。 |
| Type |
オプションの Text。 ビューのレンダリングの種類を指定します。 この種類は一般的な列挙 HTML ビューで、HTML、Chart、または Pivot に設定できます。 |
| Url |
オプションの Text。 ビューの URL を指定します。 |
| WebPartOrder |
オプションの Integer。 ゾーン内での Web パーツの垂直方向の配置を指定します。 |
| WebPartZoneID |
オプションの Text。 Web パーツのゾーンを指定します。 |
子要素
- 集計
- GroupByFooter
- GroupByHeader
- 結合
- PagedClientCallbackRowset
- PagedRecurrenceRowset
- PagedRowset
- ParameterBindings
- ProjectedFields
- Query
- RowLimit
- RowLimitExceeded
- Toolbar
- ViewBidiHeader
- ViewBody
- Viewdata
- ViewEmpty
- ViewFields
- ViewFooter
- ViewHeader
- ViewStyle
- XslLink
親要素
Occurrences
- 最小 : 0
- 最大: 制約なし
注釈
リストおよびドキュメントの概要情報の主要なビューは HTML ビューです。 HTML ビューは、一般的に、1 つ以上のリストの情報を表示する列形式のビューです。 表示されるデータは、ビューに表示されるフィールドによって記述されます。 Microsoft SharePoint Foundation 2010でのビューの動作の詳細については、「リスト ビュー」を参照してください。
HTML ビューを定義する主な属性は、次のとおりです。
- ビューの名前。
- データ ソースの指定 (通常は単一のリストまたはドキュメント ライブラリ)。
- データ ソースに適用されるフィルタ。
- 表示されるフィールドのコレクション。
- 表示されるアイテムの並べ替え順。 並べ替え順の特殊な場合がグループ化です。
- ビューをレンダリングするための HTML テンプレート。
View 要素はページのレンダリングの中心的な存在で、特定のビューで適用されるフィールド、並べ替え、およびフィルタ用の SQL クエリを生成します。 View 要素は、クエリによって返されたデータ セットを反復処理し、返される各行の ViewBody 要素を実行します。 ViewBody 要素内では、Fields 要素の列挙を使用して各フィールドを処理したり、Field 要素内で各フィールドを名前で個々に参照したりすることができます。
各ビューには、通常、GUID によって表される内部名があります。 ビューは、View/> タグを使用してページに<レンダリングできます。
例
次の例では、ビューのボディでフィールドの列挙を使用して、ブラウザでリストを表示するための基本的なテーブルをレイアウトします。
<View Name="MyCustomView">
<ViewHeader>
<HTML><![CDATA[<TABLE><TR>]]></HTML>
<Fields>
<HTML><![CDATA[<TH>]]></HTML>
<Field/>
<HTML><![CDATA[</TH>]]></HTML>
</Fields>
<HTML><![CDATA[</TR>]]></HTML>
</ViewHeader>
<ViewBody>
<HTML><![CDATA[<TR>]]></HTML>
<Fields>
<HTML><![CDATA[<TD>]]></HTML>
<Field/>
<HTML><![CDATA[</TD>]]></HTML>
</Fields>
<HTML><![CDATA[</TR>]]></HTML>
</ViewBody>
<ViewFooter>
<HTML><![CDATA[</TABLE>]]></HTML>
</ViewFooter>
前のセクションでは、フィールドの列挙を ViewHeader セクション内で使用して、ビューの列のヘッダーを作成しています。
この例の次のセクションでは、ビューに列挙するフィールドを指定するために、ViewFields セクションが View 要素内に含まれています。
<ViewFields>
<FieldRef Name="Created_x0020_By"/>
<FieldRef Name="Last_x0020_Modified"/>
</ViewFields>
注:
ビューに Joins 要素が含まれている場合、結合リストのフィールドの詳細が ProjectedFields 要素に記述されているときは、そのフィールドを ViewFields に含めることができます。
この例の最後のセクションでは、Query 要素を使用して、特定の条件を満たす結果セットを指定します。次の例では、ライブラリ内で、Mary または John によって作成されたすべてのドキュメントのリストを返します。
<Query>
<Where>
<Or>
<Eq>
<FieldRef Name="Created_x0020_By"/>
<Value Type="Text">
Mary
</Value>
</Eq>
<Eq>
<FieldRef Name="Created_x0020_By"/>
<Value Type="Text">
John
</Value>
</Eq>
</Or>
</Where>
<OrderBy>
<FieldRef Name="Last_x0020_Modified"/>
</OrderBy>
</Query>
</View>
次のビューの例では、一連の段落が表示されます。 Query 要素は、並べ替え順序 (変更日の順序) だけでなく、フィルターも指定します (Expires プロパティが今日の日付以上のアイテムのみを表示します)。
<View Type="HTML" Name="Summary">
<ViewBody ExpandXML="TRUE">
<![CDATA[ <p><SPAN class=DocTitle><ows:Field Name="Title"/></SPAN>
(<ows:Field Name="Author"/>, <ows:Field Name="Modified"/>)
<ows:Limit><Field Name="Body"/></ows:Limit>
</p> ]]>
</ViewBody>
<Query>
<Where>
<Geq>
<FieldRef Name="Expires"/>
<Value Type="DateTime">
<Today/>
</Value>
</Geq>
</Where>
<OrderBy>
<FieldRef Name="Modified"/>
</OrderBy>
</Query>
<ViewFields>
<FieldRef Name="Summary"/>
<FieldRef Name="Author"/>
<FieldRef Name="Modified"/>
<FieldRef Name="Body"/>
</ViewFields>
</View>