View 要素 (Site)
適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
サイト定義内で使用され、モジュール内のページのリスト ビューを指定します。
<View
AggregateView = "TRUE" | "FALSE"
BaseViewID = "Integer"
DefaultView = "TRUE" | "FALSE"
DisplayName = "Text"
FailIfEmpty = "TRUE" | "FALSE"
FileDialog = "TRUE" | "FALSE"
FPModified = "TRUE" | "FALSE"
FreeForm = "TRUE" | "FALSE"
Hidden = "TRUE" | "FALSE"
List = "Integer" } "Text"
Name = "Text"
OrderedView = "TRUE" | "FALSE"
PageType = "Text"
Path = "Text"
ReadOnly = "TRUE" | "FALSE"
RecurrenceRowset = "TRUE" | "FALSE"
RowLimit = "Integer"
Scope = "Text"
ShowHeaderUI = "TRUE" | "FALSE"
Threaded = "TRUE" | "FALSE"
Type = "HTML" | "Chart" | "Pivot"
Url = "URL"
WebPartOrder = "Integer"
WebPartZoneID = "Text">
</View>
要素と属性
以下のセクションで、属性、子要素、親要素について説明します。
属性
| 属性 | 説明 |
|---|---|
| AggregateView |
省略可能 なブール値。 ビューが XML フォーム ライブラリで使用されるフォームの結合ビューであることを指定する場合は TRUE。 既定では、XML フォーム ライブラリは、最初は非表示になっているマージ フォーム ビューでプロビジョニングされます。 XML エディターを使用して XML フォーム プロパティ (XFP) ファイルをライブラリの Forms ディレクトリに発行し、エディターで使用するテンプレートと共に AggregateView 属性を使用すると、マージ フォーム ビューが識別されます。これは、ライブラリのリスト テンプレートまたは定義がデータのマージをサポートしているかどうかに応じて表示または非表示にすることができます。 |
| BaseViewID |
オプションの Integer。 基本ビューの ID を指定します。 |
| DefaultView |
省略可能 なブール値。 ビューが既定のビューであることを指定する場合は TRUE。 |
| DisplayName |
オプションの Text。 サイド リンク バーに表示されるビューの名前を指定します。 |
| FailIfEmpty |
省略可能 なブール値。 ビューがアイテムを返さないときに、ViewEmpty 要素をレンダリングする代わりに、空白のページおよび HTTP エラー コードを返す場合は TRUE。 クライアント アプリケーションからのプログラムによるビューの操作を使用し、ビューが空かどうかを検出するためにクライアント アプリケーションでドキュメントを解析する必要がありません。 |
| FileDialog |
省略可能 なブール値。 Microsoft SharePoint Foundation のコンテキスト内で使用されるアプリケーションのファイル ダイアログ ボックスにビューを表示するように指定する場合は TRUE。これは、出力 HTML を解析してリストの内容を決定します。 |
| FPModified |
省略可能 なブール値。 Web ページ エディターでの編集によってビューが変更され、SharePoint Foundation ユーザー インターフェイス (UI) によってビューがカスタマイズできなくなった場合は TRUE。 |
| 自由形 状 |
省略可能 なブール値。 特定のフィールド型をレンダリングするための代替フィールド形式を指定する場合は TRUE。 特に、これは数字の列の整列に影響し、テーブル以外のカスタム ビューで便利です。 |
| Hidden |
省略可能 なブール値。 ビューを非表示にする場合は TRUE。 |
| List |
オプションの Integer または Text。 リストの種類を指定します。 この値は、リストのテンプレートの ID (整数)、またはサイトで準備されたリストの URL (文字列) のどちらかにすることができます。 Integer ではリストが特定されない場合があるため (たとえば、お知らせリストが 2 つある場合に、List=104 を指定したときなど)、Text を使用することをお勧めします。 |
| 名前 |
オプションの Text。 ビューに指定された名前 (UI で別の名前付きビューを選択したり、 ルックアップ フィールドのフィルターを指定する際に名前付きビューを参照したりするために使用されます)。 |
| OrderedView |
省略可能 なブール値。 ビューが順序付けられていることを指定する場合は TRUE。 |
| PageType |
オプションの Text。 ビューが使用されるフォームの種類を指定します。 以下のいずれかの値を使用できます。 DEFAULTVIEW 既定のビュー。 DIALOGVIEW [ファイル] ダイアログ ボックス ビュー。 DISPLAYFORM リスト アイテムのフォームを表示します。 DISPLAYFORMDIALOG ファイル ダイアログ ボックスのフォームを表示します。 EDITFORM リスト アイテムのフォームを編集します。 EDITFORMDIALOG ファイル ダイアログ ボックスのフォームを編集します。 無効です 使用されていません。 MAXITEMS 使用されていません。 NEWFORM リスト アイテムの新しいフォーム。 NEWFORMDIALOG ファイル ダイアログ ボックスの新しいフォーム。 NORMALVIEW 標準ビュー。 SOLUTIONFORM ソリューション フォーム。 ビュー 既定のビューと標準ビューの両方を含むビュー。 |
| パス |
オプションの Text。 ビューのファイル名を指定します。 |
| ReadOnly |
省略可能 なブール値。 ビューを読み取り専用にする場合は TRUE。 |
| RecurrenceRowset |
省略可能 なブール値。 ビューで定期的なイベントを展開して、定期的なイベントの各インスタンスを表示する場合は TRUE。 既定値は FALSE です。 |
| RowLimit |
オプションの Integer。 HTML のビューの種類にのみ適用されます。 1 ページにレンダリングする最大行数を指定します。 行の制限値を超えた場合は、ページの Next ボタンと Previous ボタンを使用して、返されたレコードセットの他の部分を表示できます。 RowLimit が指定されていない場合、返される既定の行数は 50 です。 ビューの種類として "None" が指定されている場合、レコードセットのすべての行が 1 行に返されます。 ビューがレンダリングされると、現在のビューがデータセットの行制限に達したかどうかに基づいて、レンダリング変数 ViewHasNextViewHasPrevと が TRUE または FALSE に設定されます。 これらの変数を、次の例のように、一連のページ定義内で使用して、ページに Next および Previous ボタンをレンダリングできます。<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 プロパティに対応します。 |
| ShowHeaderUI |
省略可能 なブール値。 ヘッダー表示モードで使用されるすべての FieldRef 要素を、HTML で UI を装飾せずにレンダリングする場合は、FALSE。 つまり、このモードが設定されている場合、UI では、列のヘッダーにハイパーリンクとして並べ替えやフィルタは提供されません。 既定値は TRUE です。 |
| スレッド |
省略可能 なブール値。 ビューで内部のグループ化を適用する場合は TRUE。 組み込みのスレッド列 (リストについて存在していると仮定) に基づいてスレッド ビューが構築されます。 ビューは、このフィールドを 2 番目の並べ替え列として並べ替えられます。 ビューの他の列を並べ替えまたはグループ化の対象として指定した場合、それらは列の並べ替え順をスレッド化する前に適用されます。 結果として、トピックごとにグループ化されたすべてのディスカッションを収集でき、コレクションの下にメッセージ スレッドを表示できます。 TRUE の場合、RowLimit 要素は、スレッド形式のディスカッション掲示板リスト ビューで使用されたときには異なる意味を持ちます。 返すアイテムの数を指定する代わりに、返すディスカッション スレッドの数を指定し、この場合 1 つのスレッドが 1 つ以上のアイテムで構成される場合があります。 この行の制限値の動作を有効にするには、Threaded 属性を TRUE に設定することに加えて、スレッド ビューをスレッド ID で並べ替える必要があります。 |
| Type |
オプションの Text。 ビューのレンダリングの種類を指定します。 この種類は一般的な列挙 HTML ビューで、HTML、Chart、Pivot、GANTT、または CALENDAR に設定できます。 |
| Url |
オプションの URL。 ビューの URL を指定します。 |
| WebPartOrder |
オプションの Integer。 ゾーン内での Web パーツの垂直方向の配置を指定します。 |
| WebPartZoneID |
オプションの Text。 Web パーツのゾーンを指定します。 |
子要素
親要素
Occurrences
- 最小 : 0
- 最大: 制約なし
注釈
View 要素を使用する例については、「Module 要素 (Site)」を参照してください。