UpdateView Method
Applies to: SharePoint Foundation 2010
Modifies the specified view of a list.
<Method ID="Text">
<SetList Scope="Request">GUID</SetList>
<SetVar Name="Cmd">NewView</SetVar>
<SetVar Name="ViewType">HTML</SetVar>
<SetVar Name="LocalizedTodayString">Text</SetVar>
<SetVar Name="LocalizedMeString">Text</SetVar>
<SetVar Name="ListVersion">0</SetVar>
<SetVar Name="ViewFPModified">[TRUE|FALSE]</SetVar>
<SetVar Name="ViewOrderk">k+1_Text</SetVar>
<SetVar Name="ShouldDisplayTitle">[TRUE|FALSE]</SetVar>
<SetVar Name="ShouldDisplayExpires">[TRUE|FALSE]</SetVar>
<SetVar Name="SortFieldm">Text</SetVar>
<SetVar Name="SortAscendingm">[TRUE|FALSE]</SetVar>
<SetVar Name="IsThereAQuery">[TRUE|FALSE]</SetVar>
<SetVar Name="FieldPickern">Text</SetVar>
<SetVar Name="OperatorPickern">Eq</SetVar>
<SetVar Name="CompareWithValuen"></SetVar>
<SetVar Name="NextIsAndn">[TRUE|FALSE]</SetVar>
<SetVar Name="GroupField1">Text</SetVar>
<SetVar Name="GroupAscending1">[TRUE|FALSE]</SetVar>
<SetVar Name="GroupField2">Text</SetVar>
<SetVar Name="GroupAscending2">[TRUE|FALSE]</SetVar>
<SetVar Name="CollapseGroups">[TRUE|FALSE]</SetVar>
<SetVar Name="TotalText">COUNT</SetVar>
<SetVar Name="ViewStyle">Integer</SetVar>
<SetVar Name="RowLimit">Integer</SetVar>
<SetVar Name="Paged">[TRUE|FALSE]</SetVar>
</Method>
Parameters
Parameter |
Description |
|---|---|
ID = "Text" |
Application-specific string. In an HTML editor compatible with Microsoft Windows SharePoint Services, such as Microsoft Office SharePoint Designer 2007, the string provides the sequence number and name of the method. |
Scope = "Request" |
When set to Request, the Scope attribute sets the variable for the scope of the enclosing Method element, unless the variable is changed by another tag. |
Name = "Cmd" |
Must be set to UpdateView. |
ViewType = "Text" |
Specifies the type of view to create. Possible values include Calendar, Grid, and HTML. |
LocalizedTodayString = "Text" |
Specifies the string used to return today's date. For example, [Today]. |
LocalizedMeString = "Text" |
Specifies the string used to return the current user. For example, [Me]. |
ListVersion = "Integer" |
Specifies the version of the list. |
ViewFPModified = "[TRUE|FALSE]" |
Specifies whether the view has been modified in Microsoft Office SharePoint Designer 2007 to such a degree that it cannot be modified in the browser. |
ViewOrdern = "n+1_Field" |
Specifies the order in which to display the specified field, where n represents an integer and Field represents the internal name of the field. For example, ViewOrder2="3_Title" specifies that the Title field is the third column displayed in relation to other columns that are displayed. The ShouldDisplayField parameter must also be specified to display the field. |
ShouldDisplayField = "[TRUE|FALSE]" |
Specifies whether a given field should be displayed in the view, where Field represents the internal name of the field. The ViewOrdern parameter must also be specified to display the field. |
SortFieldn = "tp_Field" |
Specifies a field to sort by in the view, where Field represents the internal name of the field. |
SortAscendingn = "[TRUE|FALSE]" |
Specifies whether the field represented by the SortFieldn parameter is sorted in ascending order. |
IsThereAQuery = "[TRUE|FALSE]" |
Specifies whether a filter is included in the view. |
FieldPickern = "Field" |
Specifies the internal name of a field by which to filter, where n is an integer between 1 and 10. |
OperatorPickern = "Text" |
Specifies the operator to use in the filter, where n is an integer that matches FieldPickern. Possible values include the following: Eq — Equal to Neq — Not equal to Geq — Greater than or equal to Leq — Less than or equal to Gt — Greater than Lt — Less than BeginsWith — Begins with Contains — Contains |
CompareWithValuen = "Value" |
Specifies the value against which to compare FieldPickern, where n is an integer that matches FieldPickern. |
NextIsAndn = "[TRUE|FALSE]" |
Specifies an AND condition when an additional filter is defined, where n is an integer that matches FieldPickern. |
GroupField1 = "Text" |
Specifies the internal name of a first field to group by. |
GroupAscending1 = "[TRUE|FALSE]" |
Specifies whether the first group-by field is sorted in ascending order. |
GroupField2 = "Text" |
Specifies the internal name of a second field to group by. |
GroupAscending2 = "[TRUE|FALSE]" |
Specifies whether the second group-by field is sorted in ascending order. |
CollapseGroups = "[TRUE|FALSE]" |
Specifies whether group-by fields are collapsed by default in the view. |
TotalField = "COUNT" |
Specifies that a Total row be displayed for the Field column. |
ViewStyle = "0" |
Specifies a style for the view as defined in VWSTYLES.XML in the site definition's XML folder. Possible values include the following: 0 — Basic Table 6 — Picture Library Details 12 — Boxed, no labels 13 — Boxed 14 — Document Details 15 — Newsletter 16 — Newsletter, no lines 17 — Shaded 18 — Issues Boxed 19 — Issues Boxed, no labels |
RowLimit = "Integer" |
Specifies the number of items to display per page through the view. |
Paged = "TRUE" |
Specifies whether the view is paged, which means that when the value of RowLimit is surpassed, additional items are displayed on subsequent pages. |
Decoded
<Method ID="UpdateView">
<SetVar Name="Cmd">UpdateView</SetVar>
<SetList Scope="Request">{bfce21b9-ffc9-4815-ad9c-
3e92e06876bc}</SetList>
<SetVar Name="View">{e5367bf3-43e9-45d6-bf9b-c2d120af9c86}</SetVar>
<SetVar Name="ShouldDisplayID">TRUE</SetVar>
<SetVar Name="ShouldDisplayTitle">TRUE</SetVar>
<SetVar Name="ShouldDisplayExpires">TRUE</SetVar>
<SetVar Name="ShouldDisplayLinkTitle">TRUE</SetVar>
<SetVar Name="ShouldDisplayEditor">TRUE</SetVar>
<SetVar Name="ViewOrder0">1_ID</SetVar>
<SetVar Name="ViewOrder1">2_Title</SetVar>
<SetVar Name="ViewOrder2">3_Expires</SetVar>
<SetVar Name="ViewOrder3">4_LinkTitle</SetVar>
<SetVar Name="ViewOrder4">5_Editor</SetVar>
<SetVar Name="SortField1">tp_Title</SetVar>
<SetVar Name="SortAscending1">FALSE</SetVar>
<SetVar Name="IsThereAQuery">TRUE</SetVar>
<SetVar Name="FieldPicker1">ID</SetVar>
<SetVar Name="OperatorPicker1">Gt</SetVar>
<SetVar Name="CompareWithValue1">4</SetVar>
<SetVar Name="NextIsAnd1">FALSE</SetVar>
<SetVar Name="FieldPicker2">ID</SetVar>
<SetVar Name="OperatorPicker2">Lt</SetVar>
<SetVar Name="CompareWithValue2">10</SetVar>
<SetVar Name="NextIsAnd2">FALSE</SetVar>
<SetVar Name="TotalID">COUNT</SetVar>
<SetVar Name="ViewStyle">0</SetVar>
<SetVar Name="RowLimit">100</SetVar>
<SetVar Name="Paged">TRUE</SetVar>
</Method>