Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Views.AddView - Méthode

Crée un affichage pour la liste spécifiée.

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

[SoapDocumentMethodAttribute("http://schemas.microsoft.com/sharepoint/soap/AddView", RequestNamespace = "http://schemas.microsoft.com/sharepoint/soap/", 
	ResponseNamespace = "http://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.String

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

viewName
Type : System.String

Chaî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.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 :

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 . 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.XmlNode

Un é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.String

Chaî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.Boolean

true 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" xmlns=""> 
    <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>

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 .

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