Views.AddView - Méthode
Crée un affichage pour la liste spécifiée.
Espace de noms : WebSvcviews
Assembly : STSSOAP (dans STSSOAP.dll)
Syntaxe
'Déclaration
<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)> _
Public Function AddView ( _
listName As String, _
viewName As String, _
viewFields As XmlNode, _
query As XmlNode, _
rowLimit As XmlNode, _
type As String, _
makeViewDefault As Boolean _
) As XmlNode
'Utilisation
Dim instance As Views
Dim listName As String
Dim viewName As String
Dim viewFields As XmlNode
Dim query As XmlNode
Dim rowLimit As XmlNode
Dim type As String
Dim makeViewDefault As Boolean
Dim returnValue As XmlNode
returnValue = 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)]
public XmlNode AddView(
string listName,
string viewName,
XmlNode viewFields,
XmlNode query,
XmlNode rowLimit,
string type,
bool makeViewDefault
)
Paramètres
listName
Type : System.StringChaîne qui contient le nom interne de la liste.
viewName
Type : System.StringChaîne qui contient le GUID de la vue, qui détermine l'affichage à utiliser pour les attributs d'affichage par défaut représentées par les paramètres query, viewFieldset rowLimit . Si cet argument n'est fourni, la vue par défaut est supposée.
viewFields
Type : System.Xml.XmlNodeUn é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 :
query
Type : System.Xml.XmlNodeUn é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 . Par exemple, la requête suivante retourne les éléments de liste dans laquelle l'ID est inférieur à 3 et trie les éléments par titre :
rowLimit
Type : System.Xml.XmlNodeUn élément RowLimit Spécifie le nombre d'éléments, ou des lignes, à afficher sur une page, avant le début de l'échange, 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 :
type
Type : System.StringChaîne qui indique si la vue est une vue HTML ou une feuille de données. Les valeurs possibles sont HTML et Grid.
makeViewDefault
Type : System.Booleantrue pour que l'affichage de la vue par défaut pour la liste.
Valeur renvoyée
Type : System.Xml.XmlNode
Un Collaborative Application Markup Language (CAML) de fragment dans l'écran suivant qui contient le schéma de vue et peut être affecté à un objet 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>
Exemples
L'exemple de code suivant crée une vue pour une liste spécifiée qui retourne les éléments dans lesquels la valeur d'un champ DateTime est supérieure à une date et heure 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><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);