Partager via

NEWFIELD, méthode

  • Article

Dernière modification : vendredi 30 mai 2008

S’applique à : SharePoint Foundation 2010

Ajoute un champ à une liste SharePoint.

Notes

Méthode Web service Cette méthode est obsolète et risque de ne plus être prise en charge dans les versions futures. Utilisez à la place la méthode de service Web suivante :UpdateList(String, XmlNode, XmlNode, XmlNode, XmlNode, String).

<Method ID="Text">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">NEWFIELD</SetVar>
  <SetVar Name="FieldXML">&lt;Field Name=&quot;fieldname&quot;
    MaxLength=&quot;Integer&quot; DisplayName=&quot;displayname&quot;
    Description=&quot;text&quot; Type=&quot;Text&quot;/&gt;</SetVar>
  <SetVar Name="AddToDefaultView">[ON|OFF]</SetVar>
  <SetVar Name="owshiddenversion">Integer</SetVar>
</Method>

Paramètres

Paramètre

Description

ID = "Text"

Chaîne spécifique à l'application. Dans un éditeur HTML compatible avec Windows SharePoint Services, tel que Microsoft Office SharePoint Server 2007, la chaîne fournit le numéro de séquence et le nom de la méthode.

Scope = "Request"

Lorsqu'il prend la valeur Request, l'attribut Scope définit la variable pour l'étendue de l'élément Method englobant, excepté si la variable est modifiée par une autre balise.

Name = "Cmd"

Doit prendre la valeur NEWFIELD.

Name = "FieldXML"

La description XML du nouveau champ. Pour obtenir le jeu complet des attributs et valeurs disponibles qui peuvent être inclus, voir la définition de l'élément Field dans la référence pour les Schémas principaux du langage CAML (Collaborative Application Markup Language).

Name = "AddToDefaultView"

Un affichage est un jeu nommé de règles décrivant le mode d'affichage des éléments dans une liste. Chaque liste dispose d'un affichage par défaut qui lui est associé. Si AddToDefaultView prend la valeur ON, le champ est ajouté à l'affichage par défaut ; s'il prend la valeur OFF, le champ n'est pas ajouté à cet affichage.

Name = "owshiddenversion"

Il s'agit du numéro de version actuelle de la liste. La commande NEWFIELD ne fonctionne que si Windows SharePoint Services et l'application cliente s'accordent sur le numéro de version de la liste. Cela garantit qu'un seul utilisateur à la fois peut modifier le schéma de liste.

Decoded

<Method ID="0,NEWFIELDSample">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">NEWFIELD</SetVar>
  <SetVar Name="FieldXML">&lt;Field Name=&quot;Sample&quot;
    MaxLength=&quot;255&quot; DisplayName=&quot;Sample&quot;
    Description=&quot;sample description&quot; 
        Type=&quot;Text&quot;/&gt;</SetVar>
  <SetVar Name="AddToDefaultView">ON</SetVar>
  <SetVar Name="owshiddenversion">6</SetVar>
</Method>

Voir aussi

Concepts

Format de message d’erreur pour SharePoint Foundation