Views.UpdateView - Méthode

  • Article

Modifie l'affichage spécifié de la liste spécifiée.

Espace de noms :  WebSvcviews
Assembly :  STSSOAP (dans STSSOAP.dll)

Syntaxe

'Déclaration
<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)> _
Public Function UpdateView ( _
    listName As String, _
    viewName As String, _
    viewProperties As XmlNode, _
    query As XmlNode, _
    viewFields As XmlNode, _
    aggregations As XmlNode, _
    formats As XmlNode, _
    rowLimit As XmlNode _
) As XmlNode
'Utilisation
Dim instance As Views
Dim listName As String
Dim viewName As String
Dim viewProperties As XmlNode
Dim query As XmlNode
Dim viewFields As XmlNode
Dim aggregations As XmlNode
Dim formats As XmlNode
Dim rowLimit As XmlNode
Dim returnValue As XmlNode

returnValue = 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)]
public XmlNode UpdateView(
    string listName,
    string viewName,
    XmlNode viewProperties,
    XmlNode query,
    XmlNode viewFields,
    XmlNode aggregations,
    XmlNode formats,
    XmlNode rowLimit
)

Paramètres

  • listName
    Type : System.String

    Chaîne qui contient le nom interne de la liste.

  • viewName
    Type : System.String

    Chaîne contenant le GUID de la vue.

  • viewProperties
    Type : System.Xml.XmlNode

    Un fragment XML qui contient toutes les propriétés au niveau de l'affichage en tant qu'attributs, tels que Editor, Hidden, ReadOnlyet Title.

  • query
    Type : System.Xml.XmlNode

    Un élément de requête contenant la requête qui détermine quels enregistrements sont retournés et dans quel ordre et qui peuvent être affectés à un objet System.Xml.XmlNode . L'exemple suivant exécute une requête pour les cas dans lesquels le champ ID est inférieur à 3 et affiche les éléments dans l'ordre de leurs titres :

  • viewFields
    Type : System.Xml.XmlNode

    Un élément ViewFields qui spécifie les champs à renvoyer dans la requête et qui peut être assigné à un objet System.Xml.XmlNode , comme dans l'exemple suivant :

  • aggregations
    Type : System.Xml.XmlNode

    Un élément d'agrégations qui spécifie les champs d'agrégat et qui peuvent être affectés à un objet System.Xml.XmlNode , comme dans l'exemple suivant :

  • formats
    Type : System.Xml.XmlNode

    Un élément des Formats qui définit la mise en forme des colonnes de grille et qui peuvent être attribuées à un objet System.Xml.XmlNode , comme dans l'exemple suivant :

  • rowLimit
    Type : System.Xml.XmlNode

    Un élément RowLimit qui spécifie le nombre d'articles ou de lignes, à afficher sur une page avant pagination commence et qui peuvent être attribuées à un objet System.Xml.XmlNode . Le fragment peut inclure l'attribut Paged pour indiquer que la vue retourne les éléments de liste dans les pages. L'exemple suivant définit une limite de 100 éléments par page :

Valeur renvoyée

Type : System.Xml.XmlNode
Un Collaborative Application Markup Language (CAML) fragment sous la forme suivante qui contient le schéma de la vue mise à jour et peuvent être affectées à un objet 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>

Exemples

L'exemple de code suivant modifie la requête, la limite de ligne et afficher les champs dans une vue pour une liste, en retournant les éléments dont les valeurs d'un champ DateTime et le champ Number dépassent les valeurs spécifiées. Cet exemple suppose qu'un using (C#) ou la directive Imports (Microsoft Visual Basic) être inclus dans l'espace de noms System.Xml .

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);

Voir aussi

Référence

Views classe

Views - Membres

WebSvcviews - Espace de noms