View 要素 (リスト)
最終更新日: 2015年3月9日
適用対象: SharePoint Foundation 2010
この記事の内容
属性
子要素
親要素
出現回数
リスト定義 (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 |
オプションの Boolean。ビューが XML フォーム ライブラリで使用されるフォームの結合ビューであることを指定する場合は TRUE。既定では、XML フォーム ライブラリには、最初は非表示であるフォームの結合ビューがあります。XML エディターを使用して XML Form Properties (XFP) ファイルを、エディターで使用されるテンプレートと共にライブラリの Forms ディレクトリに発行すると、AggregateView 属性によってフォームの結合ビューが識別されます。リスト テンプレートまたはライブラリの定義でデータの結合がサポートされるかどうかによって、このビューの表示と非表示を切り替えることができます。 |
BaseViewID |
オプションの Integer。基本ビューの ID を指定します。 |
ContentTypeID |
オプションの Text。ビューが関連付けられているコンテンツ タイプの ID を指定します。 |
CssStyleSheet |
オプションの Text。 |
DefaultView |
オプションの Boolean。ビューが既定のビューであることを指定する場合は TRUE。 |
DefaultViewForContentType |
オプションの Boolean。ビューがコンテンツ タイプの既定のビューであることを指定する場合は TRUE。 |
DisplayName |
オプションの Text。サイド リンク バーに表示されるビューの名前を指定します。 |
FailIfEmpty |
オプションの Boolean。ビューがアイテムを返さないときに、ViewEmpty 要素をレンダリングする代わりに、空白のページおよび HTTP エラー コードを返す場合は TRUE。クライアント アプリケーションからのプログラムによるビューの操作で使用され、クライアント アプリケーションでビューが空であるかどうかを検出するためにドキュメントを解析する必要がなくなります。 |
FileDialog |
オプションの Boolean。ビューが、SharePoint Foundation のコンテキストで使用され、出力 HTML を解析してリストの内容を確認するアプリケーションのファイル ダイアログ ボックスに表示されることを指定する場合は TRUE。 |
FPModified |
オプションの Boolean。ビューが Web ページ エディターによる編集で変更され、SharePoint Foundation のユーザー インターフェイス (UI) でビューをカスタマイズできなくなった場合は、TRUE。 |
FreeForm |
オプションの Boolean。フィールドをレンダリングするときに特定のフィールド型の代替フィールド形式を指定する場合は TRUE。特に、この属性は数字の列の整列に影響し、テーブル以外のユーザー設定ビューで便利です。 |
Hidden |
オプションの Boolean。ビューを非表示にする場合は TRUE。 |
ImageUrl |
オプションの Text。リスト ビューのタイトル領域に表示されるイメージのサーバー相対 URL を指定します (例 : /_layouts/images/pgrpicon.png)。 |
IncludeRootFolder |
オプションの Boolean。ルート フォルダーをリスト ビューに返すことを指定する場合は TRUE です。 |
List |
オプションの Integer または Text。リストの種類を指定します。この値は、リストのテンプレートの ID (整数)、またはサイトで準備されたリストの URL (文字列) のどちらかにすることができます。Integer ではリストが特定されない場合があるため (たとえば、お知らせリストが 2 つある場合に、List=104 を指定したときなど)、Text を使用することをお勧めします。 |
MobileDefaultView |
オプションの Boolean。標準の SharePoint リスト ビューが既定のモバイル ビューであることを指定する場合は TRUE。既定のモバイル ビューとして指定できるのは、リストごとに 1 つのビューだけです。 |
MobileItemLimit |
オプションの Integer。 |
MobileUrl |
オプションの Text。 |
MobileView |
オプションの Boolean。標準の SharePoint リスト ビューがモバイル ビューでもあることを指定する場合は TRUE。この属性は、予定表、データシート、またはガント ビューには適用されません。 |
ModerationType |
オプションの Text。コンテンツの承認の種類を指定します。有効な値は、HideUnapproved、Contributor、または Moderator です。HideUnapproved ビューでは、未承認の下書きアイテムは、アイテムの読み取りアクセス許可のみを持っているユーザーには表示されません。Contributor ビューでは、現在のユーザーの保留中アイテムと拒否アイテムが表示されます。Moderator ビューは、管理下にあるリストの権限を持つユーザーのみがアクセスでき、すべてのユーザーの保留中アイテムと拒否アイテムが表示されます。 |
Name |
オプションの Text。ビューに付けられた名前。UI で別の名前のビューを選択したり、Lookup フィールドのフィルターを指定するときに名前付きのビューを参照したりするために使用します。 |
OrderedView |
オプションの Boolean。ビューが順序付けられていることを指定する場合は TRUE。 |
PageType |
オプションの Text。ビューが使用されるフォームの種類を指定します。以下のいずれかの値を使用できます。
|
Path |
オプションの Text。ビューのファイル名を指定します。 |
ReadOnly |
オプションの Boolean。ビューを読み取り専用にする場合は TRUE。 |
RecurrenceRowset |
オプションの Boolean。ビューで定期的なイベントを展開して、定期的なイベントの各インスタンスを表示する場合は TRUE。既定値は FALSE です。 |
ReqAuth |
オプションの Boolean。 |
RequiresClientIntegration |
オプションの Boolean。クライアント アプリケーションを起動する機能を使用する場合は TRUE です。この機能を使用しない場合、ユーザーはドキュメントに対してローカルで作業を行い、変更内容をアップロードする必要があります。 |
RowLimit |
オプションの Integer。HTML のビューの種類にのみ適用されます。1 ページにレンダリングする最大行数を指定します。行の制限値を超えた場合は、Next ボタンと Previous ボタンを使用して、返されたすべてのレコードセットを表示できます。 RowLimit が指定されていない場合、返される既定の行数は 50 です。ビューの種類として "None" が指定されている場合、レコードセットのすべての行が 1 行に返されます。 ビューをレンダリングするときに、データセットの現在のビューが行の制限値に到達しているかどうかに基づいて、レンダリング変数 ViewHasNext および ViewHasPrev が TRUE または FALSE に設定されます。これらの変数を、次の例のように、一連のページ定義内で使用して、ページに Next および Previous ボタンをレンダリングできます。 現在の表示から次または前のページング コンテンツがある場合は、変数 NextPageURL および PrevPageURL を空白以外の値に設定することもできます。これらの変数を使用することによって、コンテンツの次のページにアクセスするための適切な URL が設定された Next および Previous ボタンを構築できます。 |
Scope |
オプションの Text。ドキュメント ライブラリのビューの再帰的な範囲を指定します。以下のいずれかの値を使用できます。
この属性が設定されていない場合、ビューには特定のフォルダーのファイルとサブフォルダーのみが表示されます。この属性の値は、SPView クラスの Scope プロパティに対応します。 |
SetupPath |
オプションの Text。ビューの .aspx ページが含まれている、設定ディレクトリ内のフォルダーへのサイト相対パスを指定します (例 : pages\viewpage.aspx)。 |
ShowHeaderUI |
オプションの Boolean。ヘッダー表示モードで使用されるすべての FieldRef 要素を、HTML で UI を装飾せずにレンダリングする場合は、FALSE。つまり、このモードが設定されている場合、UI では、列のヘッダーにハイパーリンクとして並べ替えやフィルターは提供されません。既定値は TRUE です。 |
TabularView |
オプションの Boolean。 |
TargetId |
オプションの Text。 |
TargetType |
オプションの Text。List、ContentType のいずれかの値を使用できます。 |
Threaded |
オプションの Boolean。ビューで内部のグループ化を適用する場合は TRUE。組み込みのスレッド列 (リストについて存在していると仮定) に基づいてスレッド ビューが構築されます。ビューは、このフィールドを 2 番目の並べ替え列として並べ替えられます。ビュー内の他の列の並べ替えやグループ化が指定されている場合、そのルールはスレッド列の並べ替え順の前に適用されます。結果として、トピックごとにグループ化されたすべてのディスカッションを収集でき、コレクションの下にメッセージ スレッドを表示できます。 TRUE の場合、RowLimit 要素は、スレッド形式のディスカッション掲示板リスト ビューで使用されたときには異なる意味を持ちます。返すアイテムの数を指定する代わりに、返すディスカッション スレッドの数を指定し、この場合 1 つのスレッドが 1 つ以上のアイテムで構成される場合があります。Threaded 属性を TRUE に設定することに加えて、スレッド ビューをスレッド ID で並べ替える必要があります。並べ替えをしないと、この行の制限値の動作が有効になりません。 |
ToolbarTemplate |
オプションの Text。ビューのツール バーに使用される事前定義済みのツール バー テンプレートの名前を指定します。 |
Type |
オプションの Text。ビューのレンダリングの種類を指定します。この種類は一般的な列挙 HTML ビューで、HTML、Chart、または Pivot に設定できます。 |
Url |
オプションの Text。ビューの URL を指定します。 |
WebPartOrder |
オプションの Integer。領域内での Web パーツの垂直位置を指定します。 |
WebPartZoneID |
オプションの Text。Web パーツの領域を指定します。 |
子要素
親要素
出現回数
最小 : 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>