Views.UpdateView Method

Artículo
09/28/2007

Modifica la vista especificada de la lista especificada.

Web Service: ViewsWeb Reference: http://<Site>/_vti_bin/Views.asmx

Syntax

'Declaración
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/UpdateView", RequestNamespace:="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace:="https://schemas.microsoft.com/sharepoint/soap/", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
PublicFunctionUpdateView ( _
    listNameAsString, _
    viewNameAsString, _
    viewPropertiesAsXmlNode, _
    queryAsXmlNode, _
    viewFieldsAsXmlNode, _
    aggregationsAsXmlNode, _
    formatsAsXmlNode, _
    rowLimitAsXmlNode _
) AsXmlNode
'Uso
DiminstanceAsViewsDimlistNameAsStringDimviewNameAsStringDimviewPropertiesAsXmlNodeDimqueryAsXmlNodeDimviewFieldsAsXmlNodeDimaggregationsAsXmlNodeDimformatsAsXmlNodeDimrowLimitAsXmlNodeDimreturnValueAsXmlNodereturnValue = instance.UpdateView(listName, viewName, viewProperties, query, viewFields, aggregations, formats, rowLimit)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/UpdateView", RequestNamespace="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace="https://schemas.microsoft.com/sharepoint/soap/", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)] 
publicXmlNodeUpdateView (
    stringlistName,
    stringviewName,
    XmlNodeviewProperties,
    XmlNodequery,
    XmlNodeviewFields,
    XmlNodeaggregations,
    XmlNodeformats,
    XmlNoderowLimit
)

Parameters

listName
Una cadena que contiene el nombre interno de la lista.

viewName
Una cadena que contiene el GUID de la vista.

viewProperties
Un fragmento de XML que contiene todas las propiedades de nivel de vista como atributos, como Editor, Hidden, ReadOnly y Title.

query
Un elemento Query que contiene la consulta que determina qué registros son devuelto y en qué orden y que pueden asignarse a un objeto System.Xml.XmlNode.En el siguiente ejemplo se realiza una consulta para los casos en que el campo ID es menos de 3 y muestra los elementos en el orden de sus títulos:
```
<Query>
  <Where>
    <Lt>
     <FieldRef Name="ID" />
     <Value Type="Counter">3</Value>
    </Lt>
  </Where>
  <OrderBy>
    <FieldRef Name="Title" />
  </OrderBy>
</Query>
```

viewFields
Un elemento V iewFields que especifica qué campos que se va a devolver en la consulta y que pueden asignarse a un objeto System.Xml.XmlNode,como en el ejemplo siguiente:
```
<ViewFields>
  <FieldRef Name="Title" />
  <FieldRef Name="ID" />
</ViewFields>
```

aggregations
Un elemento Aggregations que especifica los campos Para agregado y que pueden asignarse a un objeto System.Xml.XmlNode,como en el ejemplo siguiente:
```
<Aggregations Value="On">
  <FieldRef Name="Title" Type="Count">
  <FieldRef Name="Number" Type="Sum">
</Aggregations>
```

formats
Un elemento Formats que define la cuadrícula Formato de columnas y que pueden asignarse a un objeto System.Xml.XmlNode,como en el ejemplo siguiente:

<Formats>
  <FormatDef Type="RowHeight" Value="67" />
  <Format Name="Attachments">
    <FormatDef Type="ColWidth" Value="75" />
  </Format>
  <Format Name="LinkTitle">
    <FormatDef Type="WrapText" Value="1" />
    <FormatDef Type="ColWidth" Value="236" />
  </Format>
   ...
</Formats>

rowLimit
Comienza un elemento RowLimit que especifica el número de elementos, o las filas, que se van a mostrar en una página antes de paginación y que pueden asignarse a un objeto System.Xml.XmlNode.El fragmento puede incluir el atributo Paged para especificar que la vista devolver elementos de la lista de páginas. En el ejemplo siguiente se establece un límite de 100 elementos por página:
```
<RowLimit Paged="True">100</RowLimit>
```

Return Value

Un Introducción al lenguaje de marcado de aplicaciones de colaboración (CAML) fragmento en el siguiente formulario que contiene el esquema actualizado Vista y se les puede asignar a un objeto System.Xml.XmlNode.

<UpdateViewResult>
  <View Name="{B5C3250A-1974-49E9-9F61-180F86704434}" DefaultView="TRUE" Type="HTML" 
    DisplayName="All Contacts" Url="Lists/Contacts/AllItems.htm" BaseViewID="1" > 
    <ViewFields>
      <FieldRef Name="LinkTitle" />
      <FieldRef Name="FirstName" />
      <FieldRef Name="Company" />
      <FieldRef Name="WorkPhone" />
      <FieldRef Name="HomePhone" />
      <FieldRef Name="Email" />
    </ViewFields>
    <Query>
      <OrderBy>
        <FieldRef Name="Title" />
        <FieldRef Name="FirstName" />
      </OrderBy>
      <Where>
        <Lt>
          <FieldRef Name="DueDate"/>
          <Value Type="DateTime">Today + 1</Value>
        </Lt>
      </Where>
    </Query>
    <Aggregations>
      <FieldRef Name=”Column1” Type=”Minimum”>
    </Aggregations>
    <RowLimit Paged="TRUE">100</RowLimit>
  </View>
</UpdateViewResult>

Example

En el ejemplo de código siguiente se modifica el consulta, límite de filas y ver los campos de una vista para una lista, devolver elementos cuyos valores para un campo DateTime y un campo Number superan los valores especificados. En este ejemplo se requiere que un using (C#) o Directiva Imports (Microsoft Visual Basic) se incluye para el System.Xml espacio de nombres.

Dim viewService As New Web_Reference_Folder.Views()
viewService.Credentials = System.Net.CredentialCache.DefaultCredentials

Dim strQuery As String = "<Where><And><Gt>" + _
    "<FieldRef Name="Date_Field" />" + _
    "<Value Type="DateTime">2003-6-10T12:00:00Z</Value></Gt>" + _
    "<Gt><FieldRef Name="Number_Field" />" + _
    "<Value Type="Number">200</Value></Gt>" + _
    "</And></Where>" + _ 
    "<OrderBy><FieldRef Name="Title" /></OrderBy>"

Dim strRowLimit As String = "50"
Dim strViewFields As String = "<FieldRef Name="Title" />" + _
    "<FieldRef Name="Date_Field" />" + _
    "<FieldRef Name="Number_Field" />"

Dim xmlDoc = New System.Xml.XmlDocument()

Dim ndQuery As XmlNode = xmlDoc.CreateNode(XmlNodeType.Element, "Query", "")
Dim ndRowLimit As XmlNode = xmlDoc.CreateNode(XmlNodeType.Element, "RowLimit", "")
Dim ndViewFields As XmlNode = xmlDoc.CreateNode(XmlNodeType.Element, "ViewFields", "")

ndQuery.InnerXml = strQuery
ndRowLimit.InnerXml = strRowLimit
ndViewFields.InnerXml = strViewFields

Dim retNode As XmlNode = viewService.UpdateView("List_Name", _
    "9781bd25-1f68-481f-81d3-1e4f3f9216dd", Nothing, ndQuery, ndViewFields, Nothing, Nothing, ndRowLimit)

Web_Reference_Folder_Name.Views viewService = new Web_Reference_Folder_Name.Views();
viewService.Credentials= System.Net.CredentialCache.DefaultCredentials;

string strQuery = "<Where><And><Gt><FieldRef Name=\"Date_Field\" />" +
    "<Value Type=\"DateTime\">2003-6-10T12:00:00Z</Value></Gt>" +
    "<Gt><FieldRef Name=\"Number_Field\" />" +
    "<Value Type=\"Number\">200</Value></Gt></And></Where>" +
    "<OrderBy><FieldRef Name=\"Title\" /></OrderBy>";

string strRowLimit = "50";

string strViewFields = "<FieldRef Name=\"Title\" />" +
   "<FieldRef Name=\"Date_Field\" />" + 
   "<FieldRef Name=\"Number_Field\" />";

XmlDocument xmlDoc = new System.Xml.XmlDocument();

XmlNode ndQuery = xmlDoc.CreateNode(XmlNodeType.Element,"Query","");
XmlNode ndRowLimit = xmlDoc.CreateNode(XmlNodeType.Element,"RowLimit","");
XmlNode ndViewFields = xmlDoc.CreateNode(XmlNodeType.Element,"ViewFields","");

ndQuery.InnerXml = strQuery;
ndRowLimit.InnerXml = strRowLimit;
ndViewFields.InnerXml = strViewFields;

XmlNode retNode = viewService.UpdateView("List_Name",
    "9781bd25-1f68-481f-81d3-1e4f3f9216dd", null, ndQuery, ndViewFields, 
    null, null, ndRowLimit);

Compartir a través de

Views.UpdateView Method

Syntax

Parameters

Return Value

Example

See Also

Reference

Recursos adicionales