次の方法で共有

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。ビューが使用されるフォームの種類を指定します。以下のいずれかの値を使用できます。

  • DEFAULTVIEW   既定のビュー。

  • DIALOGVIEW   ファイル ダイアログ ボックス ビュー。

  • DISPLAYFORM   リスト アイテムの表示フォーム。

  • DISPLAYFORMDIALOG   ファイル ダイアログ ボックスの表示フォーム。

  • EDITFORM   リスト アイテムの編集フォーム。

  • EDITFORMDIALOG   ファイル ダイアログ ボックスの編集フォーム。

  • INVALID   使用しません。

  • MAXITEMS   使用しません。

  • NEWFORM   リスト アイテムの新規作成フォーム。

  • NEWFORMDIALOG   ファイル ダイアログ ボックスの新規作成フォーム。

  • NORMALVIEW   標準ビュー。

  • SOLUTIONFORM   ソリューション フォーム。

  • VIEW   既定のビューと標準ビューの両方を含むビュー。

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 ボタンをレンダリングできます。

<Switch>
  <Expr><GetVar Name=”ViewHasPrev”/></Expr>
  <Case Value=”TRUE”>
    <![CDATA[...Previous button defined here... ]]>
  </Case>
</Switch>

現在の表示から次または前のページング コンテンツがある場合は、変数 NextPageURL および PrevPageURL を空白以外の値に設定することもできます。これらの変数を使用することによって、コンテンツの次のページにアクセスするための適切な URL が設定された Next および Previous ボタンを構築できます。

Scope

オプションの Text。ドキュメント ライブラリのビューの再帰的な範囲を指定します。以下のいずれかの値を使用できます。

  • FilesOnly - 特定のフォルダーのファイルのみを表示します。

  • Recursive - すべてのフォルダーのすべてのファイルを表示します。

  • RecursiveAll - すべてのフォルダーのすべてのファイルとすべてのサブフォルダーを表示します。

この属性が設定されていない場合、ビューには特定のフォルダーのファイルとサブフォルダーのみが表示されます。この属性の値は、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 パーツの領域を指定します。

子要素

要素

Aggregations、GroupByFooter、GroupByHeader、Joins、PagedClientCallbackRowset、PagedRecurrenceRowset、PagedRowset、ParameterBindings、ProjectedFields、Query、RowLimit、RowLimitExceeded、Toolbar、ViewBidiHeader、ViewBody、ViewData、ViewEmpty、ViewFields、ViewFooter、ViewHeader、ViewStyle、XslLink

親要素

Views

出現回数

最小 : 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>

関連項目

その他の技術情報

リスト ビュー