Views.AddView Method

Crea una vista para la lista especificada.

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

Syntax

'Declaración
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/AddView", RequestNamespace:="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace:="https://schemas.microsoft.com/sharepoint/soap/", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
PublicFunctionAddView ( _
    listNameAsString, _
    viewNameAsString, _
    viewFieldsAsXmlNode, _
    queryAsXmlNode, _
    rowLimitAsXmlNode, _
    typeAsString, _
    makeViewDefaultAsBoolean _
) AsXmlNode
'Uso
DiminstanceAsViewsDimlistNameAsStringDimviewNameAsStringDimviewFieldsAsXmlNodeDimqueryAsXmlNodeDimrowLimitAsXmlNodeDimtypeAsStringDimmakeViewDefaultAsBooleanDimreturnValueAsXmlNodereturnValue = instance.AddView(listName, viewName, viewFields, query, rowLimit, type, makeViewDefault)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/AddView", RequestNamespace="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace="https://schemas.microsoft.com/sharepoint/soap/", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)] 
publicXmlNodeAddView (
    stringlistName,
    stringviewName,
    XmlNodeviewFields,
    XmlNodequery,
    XmlNoderowLimit,
    stringtype,
    boolmakeViewDefault
)

Parameters

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

• viewName
  Una cadena que contiene el GUID de la vista, que determina la vista y usarla con los atributos predeterminados de vista representado por la consulta query,viewFields y rowLimit parámetros. Si no se proporciona este argumento, se asume la vista predeterminada.

• 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>
  

• 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 .Por ejemplo, la siguiente consulta devuelve elementos de lista donde el identificador es inferior a 3 y ordena los elementos por título:

  <Query>
    <Where>
        <Lt>
           <FieldRef Name="ID" />
           <Value Type="Counter">3</Value>
        </Lt>
     </Where>
     <OrderBy>
        <FieldRef Name="Title" />
     </OrderBy>
  </Query>
  

• rowLimit
  Un elemento RowLimit que especifica el número de elementos, o las filas, para mostrar en una página antes de paginación comienza, 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>
  

• type
  Una cadena que especifica si la vista es una vista HTML o una vista de hoja de datos. Entre los posibles valores se incluyen HTML y Grid.

• makeViewDefault
  true Para hacer la vista la vista predeterminada para la lista.

Return Value

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

<AddViewResult>
  <View Name="{B5C3250A-1974-49E9-9F61-180F86704434}" 
    DefaultView="TRUE" Type="HTML" DisplayName="All Contacts" 
    Url="Lists/Contacts/AllItems.htm" BaseViewID="1" > 
    <RowLimit Paged="TRUE">100</RowLimit>
    <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>
    </Query>
    <Aggregations></Aggregations>
    <Formats></Formats>
  </View>
</AddViewResult>

Example

En el ejemplo de código siguiente se crea una vista para una lista especificada que devuelve los elementos en el que el valor de un campo de fecha y hora es mayor que una fecha y hora especificadas. 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><Gt>" + _
    "<FieldRef Name="DateTime_Field" />" + _
    "<Value Type="DateTime">2003-6-10T12:00:00Z</Value>" + _
    "</Gt></Where>" + _
    "<OrderBy><FieldRef Name="Title" /></OrderBy>"
Dim strRowLimit As String = "50"
Dim strViewFields As String = "<FieldRef Name="Title" />" + _
    "<FieldRef Name="DateTime_Field" />"

Dim xmlDoc As New System.Xml.XmlDocument()

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

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

Dim retNode As XmlNode = viewService.AddView("List_Name", "View_Name", ndViewFields, ndQuery, ndRowLimit, "HTML", False)

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

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

string strRowLimit = "50";

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

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

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

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

XmlNode retNode = viewService.AddView("List_Name", "View_Name", ndViewFields, ndQuery, ndRowLimit ,"HTML", false);

See Also

Reference

Views Class
Views Members
Views Web Service