Field, élément (List)

Article
09/24/2014

Dernière modification : jeudi 13 février 2014

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences

Définit les types de données internes utilisés dans l’infrastructure de liste d’un site Web SharePoint. Un champ est une colonne ou un attribut d’informations qu’un utilisateur peut ajouter à une liste.

<Field
  Aggregation = "sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  AllowDeletion = "TRUE" | "FALSE"
  AllowHyperlink = "TRUE" | "FALSE"
  AllowMultiVote = "TRUE" | "FALSE"
  AppendOnly = "TRUE" | "FALSE"
  AuthoringInfo = "Text"
  BaseType = "Integer" | "Text"
  CalType = "Integer"
  CanToggleHidden = "TRUE" | "FALSE"
  ClassInfo = "Text"
  ColName = "Text"  ColName2 = "Text"
  Commas = "TRUE" | "FALSE"  Customization = "Text"
  Decimals = "Integer"
  Description = "Text"
  Dir = "Text"  Direction = "Text"
  DisplaceOnUpgrade = "TRUE" | "FALSE"
  DisplayImage = "Text"
  DisplayName = "Text"
  DisplayNameSrcField = "Text"  DisplaySize = "Integer"
  Div = "Number"
  EnableLookup = "TRUE" | "FALSE"  EnforceUniqueValues = "TRUE" | "FALSE"
  ExceptionImage = "Text"
  FieldRef = "Text"
  FillInChoice = "TRUE" | "FALSE"
  Filterable = "TRUE" | "FALSE"
  FilterableNoRecurrence = "TRUE" | "FALSE"
  ForcedDisplay = "Text"  ForcePromoteDemote = "TRUE" | "FALSE"
  Format = "Text"
  FromBaseType = "TRUE" | "FALSE"
  Group = "Text"
  HeaderImage = "Text"
  Height = "Integer"
  Hidden = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  ID = "Text"  Id = "Text"
  IMEMode = "inactive"
  Indexed = "TRUE" | "FALSE"
  IsolateStyles = "TRUE" | "FALSE"  IsRelationship = "TRUE" | "FALSE"
  JoinColName = "Text"
  JoinRowOrdinal = "Integer"
  JoinType = "INNER" | "LEFT OUTER" | "RIGHT OUTER"
  LCID = "Integer"  LinkToItem = "TRUE" | "FALSE"  LinkToItemAllowed = "Text"
  List = "Text"  ListItemMenu = "TRUE" | "FALSE"  ListItemMenuAllowed = "Text
  Max = "Number"
  MaxLength = "Integer"
  Min = "Number" 
  Mult = "TRUE" | "FALSE"
  Name = "Text"
  NegativeFormat = "MinusSign" | "Parens"
  Node = "Text"
  NoEditFormBreak = "TRUE" | "FALSE"
  NumLines = "Integer"
  Percentage = "TRUE" | "FALSE"
  PIAttribute = "Text"
  PITarget = "Text"
  PrependId = "TRUE" | "FALSE"
  Presence = "TRUE" | "FALSE"
  PrimaryKey = "TRUE" | "FALSE"
  PrimaryPIAttribute = "Text"
  PrimaryPITarget = "Text"
  ReadOnly = "TRUE" | "FALSE"
  ReadOnlyEnforced = "TRUE" | "FALSE"  RelationshipDeleteBehavior = "Text"
  RenderXMLUsingPattern = "TRUE" | "FALSE"
  Required = "TRUE" | "FALSE"
  RestrictedMode = "TRUE" | "FALSE"
  ResultType = "Text"
  RichText = "TRUE" | "FALSE"
  RichTextMode = "Text"
  RowOrdinal = "Integer"
  Sealed = "TRUE" | "FALSE"
  SeparateLine = "TRUE" | "FALSE"
  SetAs = "Text"
  ShowAddressBookButton = "TRUE" | "FALSE"  ShowAlways = "TRUE" | "FALSE"
  ShowField = "Text" | "Choice" | "Counter"
  ShowInDisplayForm = "TRUE" | "FALSE"
  ShowInEditForm = "TRUE" | "FALSE"
  ShowInFileDlg = "TRUE" | "FALSE"
  ShowInListSettings = "TRUE" | "FALSE"
  ShowInNewForm = "TRUE" | "FALSE"
  ShowInVersionHistory = "TRUE" | "FALSE"
  ShowInViewForms = "TRUE" | "FALSE"
  Sortable = "TRUE" | "FALSE"
  SourceID = "Text"
  StaticName = "Text"
  StorageTZ = "UTC" | "Abstract"
  StripWS = "TRUE" | "FALSE"
  SuppressNameDisplay = "TRUE" | "FALSE"
  TextOnly = "TRUE" | "FALSE"
  Title = "Text" 
  Type = "Data_Type"
  UniqueId = "Text"
  UnlimitedLengthInDocumentLibrary = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsUrl = "TRUE" | "FALSE"
  UserSelectionMode = "Text"
  UserSelectionScope = "Integer"  Version = "Text"
  Viewable = "TRUE" | "FALSE"  WebId = "Text"
  Width = "Integer"
  WikiLinking = "TRUE" | "FALSE"
  XName = "Text">
</Field>

Attributs

Attribut	Description
Aggregation	Argument Text facultatif. Utilisé dans un champ de regroupement sur un formulaire XML pour spécifier la fonction à appliquer à une collection de valeurs ou d’éléments retournée par une expression XPath. Si vous utilisez l’attribut Node pour spécifier une expression XPath qui retourne une collection de valeurs, vous pouvez également inclure un attribut Aggregation qui spécifie l’action à effectuer sur le jeu de valeurs qui est retourné. Cette action peut être soit une fonction d'agrégation soit une indication de l'élément particulier au sein de la collection. Les valeurs possibles sont les suivantes : sum Ajouter les valeurs. count Compter le nombre de valeurs. average Rechercher la moyenne des valeurs. min Rechercher la valeur minimale. max Rechercher la valeur maximale. merge Fusionner les valeurs. plaintext Convertir le contenu du texte de nœud en texte brut. first Appliquer la promotion et la rétrogradation des propriétés au premier élément de la collection. last Appliquer la promotion et la rétrogradation des propriétés au dernier élément de la collection. Pour plus d’informations sur la façon dont les attributs Node, PIAttribute, PITarget, PrimaryPIAttribute et PrimaryPITarget sont utilisés pour la promotion et la rétrogradation des propriétés dans les documents XML, voir Utilisation de types de contenu pour spécifier des propriétés de document XML.
AllowDeletion	Argument Boolean facultatif. TRUE si le champ peut être supprimé.
AllowHyperlink	Argument Boolean facultatif. TRUE si les liens hypertexte peuvent être utilisés dans le champ.
AllowMultiVote	Argument Boolean facultatif. TRUE si plusieurs réponses sont autorisées dans une enquête.
AppendOnly	Argument Boolean facultatif. Lorsque le contrôle de version est activé dans la liste, TRUE si le texte peut uniquement être ajouté à la fin du texte existant dans le champ Note.
AuthoringInfo	Argument Text facultatif. Chaîne descriptive qui est affichée dans les pages de modification de champ afin d’identifier le champ et son objectif ; par exemple, le champ LinkTitle possède les informations de création « (Lien vers élément) ». Cet attribut est généralement utilisé si un champ du même nom existe dans un autre but.
BaseType	Facultatif. L’attribut BaseType peut être défini sur Integer, qui stocke les valeurs en tant qu’entiers, ou sur Text (par défaut), qui stocke les valeurs en tant que texte. Vous ne pouvez pas créer des champs de choix de type de base d’entier.
CalType	Argument Integer facultatif. Spécifie le type de calendrier. Les valeurs possibles sont les suivantes : 16 Saka Era 15 Lunaire chinois 14 Lunaire coréen et japonais 12 Grégorien (translittération en français) 11 Grégorien (translittération en anglais) 10 Grégorien (arabe) 9 Grégorien (français du Moyen-Orient) 8 Hébreu (lunaire) 7 Thaï 6 Hijri (lunaire arabe) 5 Coréen (ère Tangun) 4 Taiwanais 3 Japonais (ère impériale) 1 Grégorien 0 Sans type spécifié
CanToggleHidden	Argument Boolean facultatif. TRUE si le champ peut être masqué par le biais de l’interface utilisateur.
ClassInfo	Argument Text facultatif. Spécifie une classe de feuille de style (CSS) en cascade à utiliser pour le champ dans la vue table standard. Si cet attribut est défini, la classe spécifiée est utilisée au lieu de la classe ms-vb2 standard.
ColName	Argument Text facultatif. Attribut interne qui définit le mappage du champ sur le nom de stockage physique de ce champ. Cela doit être un nom valide dans la base de données sous-jacente et doit être identique au nom utilisé dans la table de base de données. Si cet attribut n’est pas spécifié, le serveur génère un nom de colonne qui n’entre en conflit avec aucun nom de colonne existant et qui contient uniquement des caractères autorisés par Microsoft SQL Server.
ColName2	Argument Text facultatif.
Commas	Argument Boolean facultatif. TRUE si des virgules sont utilisées pour séparer les milliers.
Customization	Argument Text facultatif.
Decimals	Argument Integer facultatif. Détermine le nombre de décimales à afficher. La valeur affichée est arrondie à la précision d’affichage supérieure ; par exemple, la valeur 1,05 est affichée sous la forme 1,1 lorsqu’elle est arrondie à une décimale.
Description	Argument Text facultatif. Fournit la description qui est affichée dans le formulaire de modification pour une liste si une description de champ est spécifiée. Par défaut, les champs dans Microsoft SharePoint Foundation ne contiennent pas de description.
Dir	Argument Text facultatif. Spécifie le sens du texte pour un champ qui prend en charge l’ordre de lecture bidirectionnel. Les valeurs possibles sont LTR (de gauche à droite), RTL (de droite à gauche) et none.
Direction	Argument Text facultatif.
DisplaceOnUpgrade	Argument Boolean facultatif. Si une définition de champ existe déjà pour le champ, TRUE pour forcer les mises à jour aux propriétés de champ à l'aide des valeurs qui sont spécifiées dans cette définition de champ.
DisplayImage	Argument Text facultatif. Spécifie le nom d’une icône qui est affichée pour la colonne.
DisplayName	Argument Text facultatif. Nom affiché pour un champ. Il n’y a aucune restriction sur la taille du texte ou sur l’utilisation des espaces. Le nom complet peut être modifié par l’utilisateur et peut changer après la création initiale du champ. Ce nom est utilisé en tant qu’en-tête de colonne lorsque le champ est affiché dans une vue table et en tant qu’étiquette de formulaire lorsque le champ est affiché dans un formulaire. La balise <FieldName/> retourne le nom complet si celui-ci est fourni ; sinon, elle prend par défaut la valeur de l’attribut Name.
DisplayNameSrcField	Argument Text facultatif. Généralement utilisé pour un champ calculé qui doit avoir le même nom qu’un autre champ. Si le champ source est modifié et que le nom complet est modifié par un utilisateur, le nom complet de ce champ change également. Cette chaîne fait référence au nom de l’autre champ.
DisplaySize	Argument Integer facultatif.
Div	Argument Number facultatif. Facteur d’échelle utilisé dans une division avant d’afficher un nombre. Le nombre affiché est N * Mult / Div (arrondi au nombre supérieur spécifié par Decimals).
EnableLookup	Argument Boolean facultatif. TRUE pour activer des valeurs de recherche dans le champ.
EnforceUniqueValues	Argument Boolean facultatif.
ExceptionImage	Argument Text facultatif. Utilisé dans un type de champ Recurrence pour spécifier le nom du fichier image à utiliser pour les exceptions.
FieldRef	Argument Text facultatif. Spécifie le nom d’un autre champ auquel le champ fait référence, tel qu’un champ de recherche.
FillInChoice	Argument Boolean facultatif. TRUE si le champ permet aux utilisateurs de remplir des valeurs pour la colonne.
Filterable	Argument Boolean facultatif. TRUE si le champ peut être filtré.
FilterableNoRecurrence	Argument Boolean facultatif. TRUE si un filtre peut être créé sur le champ dans un affichage qui ne développe pas les événements périodiques. Si Filterable contient TRUE, le champ peut être filtré dans tous les modes indépendamment de la façon dont FilterableNoRecurrence est défini.
ForcedDisplay	Argument Text facultatif. Spécifie le texte à afficher à la place de la valeur réelle du champ. Cet attribut est utilisé dans les enquêtes pour empêcher l’affichage du nom de l’utilisateur.
ForcePromoteDemote	Argument Boolean facultatif.
Format	Argument Text facultatif. Spécifie la mise en forme à utiliser pour les valeurs numériques. Pour les champs de date/heure, les valeurs suivantes sont possibles : DateOnly Afficher uniquement la partie date (et autoriser uniquement les modifications de celle-ci) (la partie horaire a la valeur 12:00 pour toutes les valeurs modifiées). DateTime Afficher et modifier la date et l’heure du jour (valeur par défaut). ISO8601 Afficher la date et l’heure dans le format d’heure ISO8601 converti au format Temps universel coordonné (UTC) : YYYY-MM-DDTHH:MM:SSZ. Il s’agit du format utilisé pour les propriétés de document dans Microsoft Office System 2007 ainsi que pour le format d’échange standard utilisé dans SharePoint Foundation entre les formulaires New et Edit et le serveur. ISO8601Basic Utilisez la forme abrégée des formats de date/heure 8601 : YYYYMMDDTHHMMSSZ. Il s'agit du format utilisé pour vCard/iCal. Pour les champs de choix, cet attribut peut être défini sur Dropdown (par défaut), qui fournit des options d’édition via une liste déroulante, ou sur RadioButtons, qui fournit des options à travers un groupe de cases d’option. Pour les champs d’URL, cet attribut peut être défini sur Hyperlink (par défaut), qui affiche l’URL en tant que balise <A> normale, ou sur Image, qui affiche l’URL en tant que <IMG SRC="URL" ALT="Description">.
FromBaseType	Argument Boolean facultatif. Cet attribut est désapprouvé en faveur de l’attribut Sealed.
Group	Argument Text facultatif. Spécifie le groupe de colonnes auquel appartient le formulaire.
HeaderImage	Argument Text facultatif. Spécifie le nom d’un fichier image à utiliser comme en-tête dans le champ.
Height	Argument Integer facultatif. Spécifie la hauteur en pixels des images qui sont affichées pour les utilisateurs dans la liste d'informations utilisateur.
Hidden	Argument Boolean facultatif. Si la valeur est TRUE, le champ est complètement masqué dans l’interface utilisateur. La définition de ReadOnly sur TRUE signifie que le champ n’est pas affiché dans les formulaires nouveaux ou modifiés mais peut toujours être inclus dans les vues.
HTMLEncode	Argument Boolean facultatif. TRUE pour convertir des caractères incorporés de façon à ce qu’ils s’affichent sous forme de texte dans le navigateur ; les caractères qui peuvent être confondus avec des balises HTML sont convertis en entités.
ID	Argument Text facultatif. Spécifie le GUID du champ contenu entre accolades ({}).
Id	Argument Text facultatif.
IMEMode	Argument Text facultatif. Spécifie l’écart en mode de l’éditeur de méthode d’entrée (IME) à utiliser pour le champ. L’éditeur IME permet de convertir des séquences de touches entre les langues lorsqu’un système d’écriture a davantage de caractères que le nombre de caractères pouvant être codés pour le clavier donné. Les valeurs possibles sont les suivantes : auto Non utilisée. Pour spécifier ce mode IME, définissez la valeur de la propriété IMEMode à l'aide d'une chaîne vide (""). active Tous les caractères sont tapés via l'éditeur IME (Input Method Editor), que les utilisateurs peuvent par ailleurs désactiver. inactive Les caractères sont tapés sans l’éditeur IME, bien que les utilisateurs puissent toujours activer l’éditeur IME.
Indexed	Argument Boolean facultatif. TRUE si la colonne est indexée pour être utilisée dans les filtres d'affichage.
IsolateStyles	Argument Boolean facultatif. Pour un champ Text dont l'attribut RichText est TRUE et dont l'attribut RichTextMode est FullHtml, cet attribut spécifie qu'un serveur réécrit le code HTML du champ pour veiller à ce qu'il n'interfère pas avec le rendu de la page qui l'entoure.
IsRelationship	Argument Boolean facultatif. TRUE si le champ est identifiable à partir de la liste dans laquelle il recherche sa valeur.
JoinColName	Argument Text facultatif. cet attribut est défini uniquement pour des champs de recherche. Il est très similaire à ColName, à ceci près qu’il désigne le nom de la colonne qui est utilisé dans l’instruction SQL JOIN entre les listes locales et externes. En règle générale, cette valeur ne doit pas être personnalisée. Elle est actuellement utilisée uniquement dans le schéma de certains des champs intégrés et de type de base pour indiquer les recherches dans la table des URL (DocMd), qui est jointe sur la colonne UrlID.
JoinRowOrdinal	Argument Integer facultatif. Non destiné à être utilisé directement à partir de votre code.
JoinType	Argument Text facultatif. Spécifie le type de jointure utilisé sur le champ. Les valeurs possibles sont INNER, LEFTOUTER et RIGHTOUTER.
LCID	Argument Integer facultatif. L’attribut LCID peut être utilisé pour spécifier le pays ou la région dont le format monétaire est utilisé, par exemple, 1033 pour les États-Unis. Deux cas spéciaux impliquent le format de symbole de l’euro. Si LCID =-1 (0xFFFFFFF), le symbole de l’euro est ajouté en tant que préfixe au nombre. Si LCID =-2 (0xFFFFFFE), le symbole de l’euro est ajouté comme suffixe au nombre. Le nombre de chiffres décimaux est 2, bien que cela puisse être substitué par l’attribut Decimals du champ. Le symbole monétaire de l’euro est égal à 0x20AC dans UCS-2.
LinkToItem	Argument Boolean facultatif.
LinkToItemAllowed	Argument Text facultatif.
List	Argument Text facultatif. Spécifie le nom interne d’une liste.
ListItemMenu	Argument Boolean facultatif.
ListItemMenuAllowed	Argument Text facultatif.
Max	Argument Number facultatif. Spécifie la valeur maximale autorisée pour le champ.
MaxLength	Argument Integer facultatif. Spécifie le nombre maximal de caractères autorisé dans une valeur de champ. Les formulaires de modification sont ajustés de manière à mettre en œuvre cette valeur, qui est validée sur le client. Si l’utilisateur tente d’entrer un nombre de caractères supérieur à celui défini par MaxLength, un message d’erreur s’affiche.
Min	Argument Number facultatif. Spécifie la valeur minimale autorisée pour le champ.
Mult	Argument Boolean facultatif. Facteur d’échelle utilisé dans la multiplication avant l’affichage d’un nombre.
Name	Argument Text obligatoire. Nom d’un champ. Il s’agit du nom interne d’un champ et est conçu de manière à ne pas évoluer durant toute la durée de vie de la définition de champ. Il doit être unique par rapport à l’ensemble des champs dans une liste. Le nom est généré automatiquement en fonction du nom d’un champ défini par l’utilisateur.
NegativeFormat	Argument Text facultatif. Spécifie comment indiquer les valeurs négatives. Peut être défini sur l’une des valeurs suivantes : MinusSign Utiliser le signe moins comme préfixe. Parens Entourer de parenthèses.
Node	Argument Text facultatif. Utilisé dans les formulaires XML, cet attribut est requis pour tous les champs, à l’exception des liens d’instruction de traitement, et spécifie l’expression XPath pour un nœud qui est promu.
NoEditFormBreak	Argument Boolean facultatif. TRUE pour empêcher un saut de ligne d’être ajouté entre les champs dans le formulaire de nouvel élément ou dans le formulaire de modification d’élément. Certains types de champ, comme un champ de texte enrichi, fournissent l’espacement par défaut, et cet attribut permet de contrôler l’espacement supplémentaire qui en résulte.
NumLines	Argument Integer facultatif. Recommande le nombre de lignes (lignes) à afficher dans un bloc TEXTAREA pendant la modification. Il s’agit simplement d’une indication de l’interface utilisateur du client ; aucune limitation n’est imposée sur le nombre de lignes de texte qui peut être modifié.
Percentage	Argument Boolean facultatif. TRUE si la valeur est affichée sous la forme d’un pourcentage ; autrement dit, un nombre multiplié par 100 auquel un signe pourcentage (%) est ajouté.
PIAttribute	Argument Text facultatif. Spécifie l’attribut dans l’instruction de traitement du document (spécifiée par l’attribut PITarget) à utiliser en tant que valeur de colonne. Utilisé pour la promotion et la rétrogradation des propriétés dans les documents XML. Si vous spécifiez l'attribut PIAttribute, vous devez également spécifier l'attribut PITarget. Pour plus d’informations sur l’utilisation des attributs Node, PIAttribute, PITarget, Primary PIAttribute et PrimaryPITarget pour la promotion et la rétrogradation des propriétés dans les documents XML, voir Utilisation de types de contenu pour spécifier des propriétés de document XML.
PITarget	Argument Text facultatif. Spécifie l’instruction de traitement de document dans laquelle la valeur de la colonne est stockée pour les documents de ce type de contenu. Utilisé pour la promotion et la rétrogradation des propriétés dans les documents XML. Si vous spécifiez l'attribut PIAttribute, vous devez également spécifier l'attribut PITarget. Pour plus d’informations sur l’utilisation des attributs Node, PIAttribute, PITarget, Primary PIAttribute et PrimaryPITarget pour la promotion et la rétrogradation des propriétés dans les documents XML, voir Utilisation de types de contenu pour spécifier des propriétés de document XML.
PrependId	Argument Boolean facultatif. Utilisé dans les listes de suivi des problèmes, TRUE pour afficher les ID de collection des problèmes connexes dans les formulaires d'édition et de création d'éléments.
Presence	Argument Boolean facultatif. TRUE si les informations utilisateur sont présentes pour le champ.
PrimaryKey	Argument Boolean facultatif. TRUE si le champ est la clé primaire dans la relation entre la liste et une autre liste.
PrimaryPIAttribute	Argument Text facultatif. Utilisé pour la promotion et la rétrogradation de propriété dans les documents XML. Spécifie un autre attribut dans l'instruction de traitement de document, spécifié par PrimaryPITarget, à utiliser comme valeur de colonne. Si vous spécifiez l’attribut PrimaryPIAttribute, vous devez également spécifier l’attribut PrimaryPITarget. S’il est spécifié, SharePoint Foundation utilise ces valeurs avant celles spécifiées dans les attributs PITarget et PIAttribute. Pour plus d’informations sur l’utilisation des attributs Node, PIAttribute, PITarget, Primary PIAttribute et PrimaryPITarget pour la promotion et la rétrogradation des propriétés dans les documents XML, voir Utilisation de types de contenu pour spécifier des propriétés de document XML.
PrimaryPITarget	Argument Text facultatif. Spécifie une autre instruction de traitement de document dans laquelle la valeur de la colonne est stockée pour les documents de ce type de contenu. Si vous spécifiez l'attribut PrimaryPIAttribute, vous devez également spécifier l'attribut PrimaryPITarget. Si l'attribut est spécifié, SharePoint Foundation utilise ces valeurs avant celles spécifiées dans les attributs PITarget et PIAttribute. Pour plus d’informations sur l’utilisation des attributs Node, PIAttribute, PITarget, Primary PIAttribute et PrimaryPITarget pour la promotion et la rétrogradation des propriétés dans les documents XML, voir Utilisation de types de contenu pour spécifier des propriétés de document XML.
ReadOnly	Argument Boolean facultatif. Si la valeur est TRUE, le champ n’est pas affiché dans les formulaires nouveaux ou modifiés mais peut être inclus dans les vues. En outre, la définition de ReadOnly sur TRUE masque le champ dans les pages Paramètres du site pour la gestion des colonnes de site et des types de contenu. La définition de l’attribut Hidden sur TRUE masque complètement le champ dans l’interface utilisateur. Si vous n’incluez pas cet attribut, SharePoint Foundation traite la colonne comme si cet attribut était défini sur False.
ReadOnlyEnforced	Argument Boolean facultatif. TRUE pour spécifier que l'utilisateur ne peut pas modifier le champ par quelque moyen que ce soit et qu'il ne peut être modifié par le système.
RelationshipDeleteBehavior	Argument Text facultatif. Spécifie le comportement de suppression du champ. Les values possibles sont Cascade, Restrict et None.
RenderXMLUsingPattern	Argument Boolean facultatif. Utilisé pour les champs calculés pour déterminer le format d’affichage. Si la valeur est TRUE, les valeurs sont restituées en fonction du modèle d’affichage du champ calculé, et non de la valeur de colonne de la première référence de champ non calculé sur laquelle le champ calculé repose. Par exemple, dans une bibliothèque d’images, la colonne Taille de l’image est représentée par largeur x hauteur, mais si cet attribut n’est pas défini sur TRUE, seule la première référence de champ, largeur, s’affiche. S’il est défini sur TRUE, le format de largeur x hauteur s’affiche.
Required	Argument Boolean facultatif. Si la valeur est TRUE, le champ ne doit pas être affecté d’une valeur vide. Si une valeur de champ non vide n’est pas accordée dans une publication de formulaire, le texte de champ requis standard ou un message explicitement spécifié (autrement dit, via des balises <ErrorText>) est affiché dans le formulaire d’erreur. Cette validation est gérée uniquement par le client (la base de données autorise toujours NULL pour tous les champs définis par l’utilisateur).
RestrictedMode	Argument Boolean facultatif. TRUE pour ne pas autoriser le champ Note à contenir des mises en forme de texte riches, telles que des images, des tableaux ou des liens hypertexte, ou autoriser le collage de texte mis en forme dans le champ.
ResultType	Argument Text facultatif. Spécifie le type de données des valeurs qui sont retournées depuis le champ.
RichText	Argument Boolean facultatif. TRUE si le champ affiche la mise en forme du texte enrichi.
RowOrdinal	Argument Integer facultatif. Spécifie l'emplacement de la base de données pour le champ.
Sealed	Argument Boolean facultatif. La définition de cet attribut sur TRUE pour un champ dans le fichier Schema.xml pour une liste marque le champ comme étant inamovible dans la page Modifier la colonne.
SeparateLine	Argument Boolean facultatif. Utilisé en interne pour prendre en charge le rendu d’un champ (tel qu’un champ de notes ou de commentaires) dans une ligne distincte. Cet attribut n’est pas destiné à une utilisation publique.
SetAs	Non destiné à être utilisé directement à partir de votre code.
ShowAddressBookButton	Non destiné à être utilisé directement à partir de votre code.
ShowAlways	Argument Boolean facultatif.
ShowField	Facultatif. L'attribut ShowField peut être défini par le nom du champ à afficher. Par défaut, un texte à lien hypertexte provenant du champ Titre de l'enregistrement dans la liste externe est affiché. Mais l'attribut ShowField peut être utilisé pour substituer cela et afficher un autre champ de la liste externe. Les types de données suivants sont autorisés comme cibles d'un attribut ShowField : Text, Choice et Counter. Pour un champ Lookup, ce paramètre doit être défini sur le nom de champ interne ; définir le nom complet ne déclenche pas d'erreur, mais brise le champ.
ShowInDisplayForm	Argument Boolean facultatif. TRUE pour afficher le champ dans le formulaire afin d’afficher l’élément.
ShowInEditForm	Argument Boolean facultatif. TRUE pour afficher le champ dans le formulaire afin de modifier l’élément.
ShowInFileDlg	Argument Boolean facultatif. Cet attribut est valide uniquement pour les champs dans les schémas de bibliothèques de documents. Si la valeur est FALSE, le champ n’apparaît pas dans la boîte de dialogue des propriétés pour l’enregistrement des formulaires qui s’affiche lorsqu’un enregistrement est effectué à partir des applications clientes. Par exemple, le champ Titre a cet attribut, car celui-ci est défini directement dans le document enregistré dans la bibliothèque de documents.
ShowInListSettings	Argument Boolean facultatif. TRUE pour afficher la colonne dans la page permettant de personnaliser les paramètres de liste.
ShowInNewForm	Argument Boolean facultatif. Si la valeur est FALSE, le champ n’apparaît pas dans une énumération Fields lorsque le mode d’affichage est défini sur New. Les champs affectés de ce paramètre n’apparaissent pas dans la page Nouvel élément par défaut pour une liste donnée. En particulier, cet attribut est utilisé pour masquer les champs dans la page permettant de télécharger des documents vers la bibliothèque de documents.
ShowInVersionHistory	Argument Boolean facultatif. TRUE pour afficher la colonne dans la page d’affichage des versions des éléments de liste.
ShowInViewForms	Argument Boolean facultatif. TRUE pour spécifier que le champ est affiché dans des pages qui servent à afficher des données en liste.
Sortable	Argument Boolean facultatif. TRUE si les valeurs du champ peuvent être triées.
SourceID	Argument Text facultatif. Contient l'espace de noms qui définit le champ, tel que https://schemas.microsoft.com/sharepoint/v3, ou le GUID de la liste dans laquelle le champ personnalisé a été créé.
StaticName	Argument Text facultatif. Contient le nom interne du champ.
StorageTZ	Spécifie la façon dont les valeurs date/heure sont stockées. Lorsque StorageTZ a la valeur UTC, les date et heure sont gérées selon le temps universel (UTC Universal Time). Pour indiquer qu’une valeur date/heure fait référence à une heure « abstraite », ce qui signifie que les date et heure sont stockées dans la base de données telles qu’elles sont entrées par l’utilisateur sans conversion ou stockage du fuseau horaire local, omettez l’attribut StorageTZ.
StripWS	Argument Boolean facultatif. TRUE si l’espace est supprimé au début et à la fin des valeurs de champs.
SuppressNameDisplay	Argument Boolean facultatif. TRUE pour ne pas afficher le nom de l’utilisateur dans un champ User.
TextOnly	Argument Boolean facultatif. Si la valeur est TRUE, le champ peut contenir uniquement des valeurs Text.
Title	Argument Text facultatif. Contient le titre du champ qui est affiché dans l’interface utilisateur.
Type	Argument Text obligatoire. Type de données du champ (sauf si l’élément Field est un enfant de ProjectedFields). Remarque Dans la version préliminaire de Microsoft SharePoint Foundation 2010, l’attribut Type a une signification différente et une seule valeur possible (« Lookup ») lorsqu’il s’agit d’un enfant de ProjectedFields. Pour plus d’informations sur cette utilisation de Type, voir ProjectedFields, élément (View). SharePoint Foundation comprend les types de données suivants par défaut : AllDayEvent Spécifie un événement d'une journée entière. Correspond au type de données SQL bit. Attachments Stocke les URL des pièces jointes. Correspond au type de données SQL bit. Boolean Utilisé pour stocker une valeur TRUE/FALSE (stockées dans la base de données en tant que 0 ou 1). Ce champ peut être trié et regroupé. Correspond au type de données SQL bit et représenté par la classe SPFieldBoolean. Calculated Spécifie un champ dont la valeur est calculée en fonction d’autres colonnes. Correspond au type de données SQL sql_variant et est représenté par la classe SPFieldCalculated. Choice Permet à l'utilisateur de spécifier un ensemble prédéterminé de valeurs pouvant être utilisées pour entrer des données dans le champ. Les types Choice et Lookup sont les principaux champs de tri et de regroupement. Les attributs BaseType et Format peuvent être utilisés pour les champs de choix. Ce champ peut être trié et regroupé. Lorsqu’une valeur est donnée comme option de choix, cette valeur est utilisée en tant que valeur soumise pour la sélection de champ. Lorsque aucune valeur n’est donnée, ce choix est soumis en tant que valeur texte du choix. Dans tous les cas, la valeur texte du choix est ce qui est affiché dans l’interface utilisateur (liste déroulante ou texte de case d’option). L’ordre dans lequel les choix apparaissent dans l’interface utilisateur de modification est toujours l’ordre dans lequel les éléments sont spécifiés dans l’élément CHOICES. Utilisez le type MultiChoice pour spécifier un champ Choice qui implémente des cases à cocher et permet à l’utilisateur de sélectionner plusieurs valeurs. Correspond au type de données SQL nvarchar et est représenté par la classe SPFieldChoice. Computed Spécifie un champ dont le contenu dépend d’un autre champ. Par exemple, un champ LinkTitleNoMenu revient à entourer une valeur de champ de titre d’un lien hypertexte. Représenté par la classe SPFieldComputed. ContentTypeId Contient un ID de type de contenu. Pour plus d’informations sur le format des ID de type de contenu, voir ID de type de contenu. Correspond au type de données SQL varbinary. Counter En règle générale, utilisé uniquement pour le champ ID interne. Sa valeur entière est définie automatiquement de manière à être unique par rapport à tout autre élément dans la liste actuelle. Le type Counter est toujours en lecture seule et ne peut pas être défini via une publication de formulaire. Ce champ peut être trié mais pas regroupé. Correspond au type de données SQL int. CrossProjectLink Utilisé pour connecter un événement dans une liste SharePoint à un site d’espace de travail de réunion ; fait spécifiquement référence au type de champ de la case à cocher utilisée dans les formulaires de nouvel élément ou de modification d’élément afin de créer un site d’espace de travail de réunion pour l’élément. Correspond au type de données SQL bit et est représenté par la classe SPFieldCrossProjectLink. Currency Permet d’entrer une valeur monétaire. Chaque champ de devise est lié à une devise spécifique aux paramètres régionaux. Dans tous les autres aspects, il est traité comme le type de champ Number. Utilisez l’attribut LCID pour indiquer une devise spécifique aux paramètres régionaux. Les attributs Decimals, Max et Min peuvent être utilisés pour les types monétaires. Ce champ peut être trié et regroupé. Correspond au type de données SQL float et est représenté par la classe SPFieldCurrency. DateTime Permet le stockage d'une date ou d'une heure complète du jour. Utilisez l'attribut Format pour spécifier le format de la date et utilisez l'attribut StorageTZ pour déterminer le mode de stockage des valeurs de date/heure. Ce champ peut être trié et regroupé. Pour le mode d’affichage, l’ordre de la mise en forme de la date est tiré des paramètres régionaux (« M/D/Y » ou « D/M/Y »). En mode édition (ou en mode création pour la valeur de l’élément Default), les dates et heures sont restituées dans le format universel : M/D/Y hh:mm am/pm. Correspond au type de données SQL datetime et est représenté par la classe SPFieldDateTime. File Correspond au type de données SQL uniqueidentifier. GridChoice Contient une échelle d’évaluation pour les enquêtes. Correspond au type de données SQL ntext et est représenté par la classe SPFieldRatingScale. Guid Autorise les identificateurs globaux uniques (GUID). Correspond au type de données SQL uniqueidentifier. Integer Autorise les valeurs entières positives ou négatives. Les attributs Commas et NegativeFormat sont utilisés pour spécifier la mise en forme des entiers. Correspond au type de données SQL int. Lookup Se comporte d’une façon très similaire à un champ Choice, à ceci près que les options disponibles proviennent d’une autre liste, au lieu d’être une sélection de valeurs codée de manière irréversible. Les attributs List et ShowField peuvent être utilisés pour des champs de recherche. Ce champ peut être trié et regroupé. Pour le tri et le regroupement, utilisez la valeur DisplayField (Titre, par défaut) plutôt que la clé étrangère stockée dans la liste. Correspond au type de données SQL int et est représenté par la classe SPFieldLookup. LookupMulti Champ Lookup qui peut contenir plusieurs valeurs. Type parent : Lookup. ModStat Contient l’état de l’approbation du contenu. Les valeurs possibles sont notamment Approved (par défaut), Rejected et Pending (stockées dans la base de données sous la forme 0, 1 ou 2, respectivement). Correspond au type de données SQL int. MultiChoice Spécifie un champ Choice qui implémente des cases à cocher et permet à l’utilisateur de sélectionner plusieurs valeurs. Correspond au type de données SQL ntext et est représenté par la classe SPFieldMultiChoice. MultiColumn Champ Note qui émule un champ contenant plusieurs valeurs. Pour un exemple d’un type de champ à plusieurs colonnes, voir Procédure : créer une définition de type de champ personnalisé. Pour plus d’informations sur les champs à plusieurs colonnes, voir Classes de champ multicolonne personnalisées. Type parent : Note. Note Permet aux utilisateurs d'entrer plusieurs lignes de texte. Ce champ ne peut pas être trié ni regroupé. Tout le texte est défini pour être constitué de caractères ASCII bruts sans balisage HTML. Tout ce qui ressemble à du balisage HTML ou à une URL est simplement placé entre guillemets (par exemple, Server.HTMLEncode) pour ressembler à du texte brut. Le contrôle pour modifier ce format est un bloc TEXTAREA simple. Utilisez l’attribut NumLines pour spécifier le nombre de lignes à afficher. Correspond au type de données SQL ntext et est représenté par la classe SPFieldMultiLineText. Number Permet l'entrée d'un nombre à virgule flottante. Ce champ peut être trié et regroupé. Les nombres entrés sont analysés conformément aux paramètres régionaux en vigueur en matière de décimales et de séparateurs des milliers. Les nombres négatifs peuvent être indiqués en les enveloppant dans des parenthèses ou en utilisant un symbole négatif. Les attributs suivants peuvent être utilisés conjointement à l'attribut Number pour spécifier la mise en forme des nombres : Decimals, Div, Max, Min, Mult et Percentage. Correspond au type de données SQL float et est représenté par la classe SPFieldNumber. PageSeparator Insère un saut de page dans une liste d’enquêtes. Représenté par la classe SPFieldPageSeparator. Recurrence Utilisé pour modifier et définir le critère de périodicité pour un élément dans une liste d’événements. Correspond au type de données SQL bit. Text Une seule ligne de texte entré dans une zone d’édition. Ce champ peut être trié et regroupé. Utilisez l’attribut MaxLength pour définir un nombre maximal de caractères autorisés. Correspond au type de données SQL nvarchar et est représenté par la classe SPFieldText. ThreadIndex Contient l’ID qui indique la position relative d’un message dans un thread de conversation. Correspond au type de données SQL varbinary. Threading Le type de champ Threading est utilisé dans la création et l’affichage des affichages de type discussion à thème. N’importe quelle liste peut contenir une colonne de threading, mais une interface utilisateur spéciale est générée lorsqu’elle est utilisée. (Elle ne s’affiche jamais en tant que champ modifiable standard dans un formulaire ni en tant que colonne normale dans une vue.) Si un tri est exécuté sur un champ de threading, un parcours de préordre de tous les enregistrements dans une relation parent-enfant est retourné. Pour ce faire, la concaténation de la date de création et du numéro d’identification de tous les enregistrements parents d’un enregistrement particulier est enregistrée. Correspond au type de données SQL varchar. URL Utilisé pour créer un lien hypertexte à main levée. Un champ URL est affiché en tant que <A HREF="URL">Description</A>. Si aucune description n’est spécifiée, il s’affiche en tant qu’<A HREF="URL">URL</A>. Le texte de l’URL est lui-même stocké dans la table des URL (DocMd), qui stocke toutes les URL dans les bases de données SharePoint sur le serveur. De la sorte, les URL qui sont locales sur le serveur peuvent être mises à jour par le biais d’une correction de liens lorsque leur destination change. Lorsqu’un enregistrement contenant un champ URL est supprimé, l’enregistrement référencé correspondant dans la table des URL est également supprimé. Ce champ peut être trié et regroupé. (Le tri est défini en fonction de la description textuelle plutôt que du contenu de l’URL ; si aucune description n’est spécifiée, le tri porte sur des données vierges.) Lorsque Type a pour valeur URL, l’attribut LinkType peut être utilisé pour spécifier le type de liaison. Correspond au type de données SQL nvarchar et est représenté par la classe SPFieldUrl. User Champ Lookup qui fait référence à la table de base de données des informations utilisateur. Correspond au type de données SQL int et est représenté par la classe SPFieldUser. UserMulti Champ User qui peut contenir plusieurs valeurs. Type parent : LookupMulti. WorkflowEventType Spécifie un type d’événement de flux de travail tel que représenté par l’énumération SPWorkflowHistoryEventType. Type parent : Integer. WorkflowStatus Spécifie l'état du flux de travail représenté par l'énumération SPWorkflowStatus. Correspond au type de données SQL nvarchar.
UniqueId	Argument Text facultatif. Non destiné à être utilisé directement à partir de votre code.
UnlimitedLengthInDocumentLibrary	Argument Boolean facultatif. TRUE pour autoriser une longueur de champ illimitée dans les bibliothèques de documents.
URLEncode	Argument Boolean facultatif. TRUE pour convertir des caractères spéciaux, tels que des espaces, dans un format UTF-8, par exemple, %c3%ab pour le caractère ë.
URLEncodeAsURL	Argument Boolean facultatif. Similaire à URLEncode, mais la valeur TRUE permet de spécifier que la chaîne à coder est un composant de chemin d’une URL de sorte que les barres obliques (/) ne sont pas codées.
UserSelectionMode	Argument Text facultatif. Spécifie si seuls les noms des utilisateurs individuels peuvent être sélectionnés dans un champ utilisateur dans un formulaire d'élément, ou si à la fois les noms de personnes et de groupes peuvent être sélectionnés. Les valeurs suivantes sont possibles : 0 - Seuls les noms des personnes peuvent être sélectionnés. 1 - À la fois les noms de personnes et de groupes peuvent être sélectionnés.
UserSelectionScope	Argument Integer facultatif. Spécifie une étendue de sélection des noms d'utilisateur dans un champ utilisateur sur un formulaire d'élément. Si la valeur est 0, aucune restriction n'est imposée à un groupe SharePoint. Si la valeur est supérieure à 0, la sélection des utilisateurs est limitée aux membres du groupe SharePoint dont l'ID est égale à la valeur qui est spécifiée.
Version	Argument Text facultatif.
Viewable	Argument Boolean facultatif. TRUE pour spécifier que le champ est ajouté à la vue par défaut. La valeur par défaut est TRUE.
WebId	Argument Text facultatif.
Width	Argument Integer facultatif. Spécifie la largeur en pixels des images qui sont affichées pour les utilisateurs dans la liste Informations utilisateur.
WikiLinking	Argument Boolean facultatif. TRUE pour spécifier que des liens Wiki, qui apparaissent sous la forme de crochets doubles ( [[…]]), soient convertis en liens HTML, qui utilisent la balise <a>.
XName	Argument Text facultatif. Utilisé en interne dans les formulaires XML pour identifier les champs qui ont été ajoutés, supprimés ou modifiés. Cet attribut n’est pas destiné à une utilisation publique.

Éléments enfants

CHOICES, Customization, Default, DefaultFormula, DisplayBidiPattern, DisplayPattern, FieldRefs, Formula, FormulaDisplayNames, MAPPINGS, Validation

Éléments parents

Fields, ProjectedFields

Occurrences

Minimum : 0

Maximum : pas de limite lorsque le parent est Fields. Lorsque le parent est ProjectedFields, le maximum est la différence entre le nombre maximal de champs autorisés dans la liste principale en cours d’interrogation et le nombre de champs figurant déjà dans la liste.

Remarques

Pour créer une définition de champ personnalisé pour une définition de liste reposant sur un type de champ SharePoint Foundation par défaut, utilisez l’élément Field (List - Definition) dans un fichier Schema.xml. Pour créer une définition de champ personnalisé en tant que Composant fonctionnel enfichable basé sur un type de champ par défaut pouvant être réutilisé sur différents sites Web et listes au sein d’une collection de sites, utilisez l’élément Field (Field) pour définir une colonne de site personnalisée. Pour créer un type de champ personnalisé qui implémente une classe personnalisée pour une validation de données et un rendu de champ spéciaux, utilisez l’élément Field (Field Types).

Les champs peuvent être référencés à partir de définitions d'affichage ou d'expressions contenues dans des éléments de rendu de champ calculé. Utilisez l'élément Field (View) pour renvoyer une valeur de champ mis en forme à afficher dans une vue et utilisez l'élément Column (View) pour renvoyer la valeur des données brutes du champ. La syntaxe pour faire référence à un champ se présente comme suit :

<Field Name="FieldName"/>

Par défaut, le champ est rendu avec les attributs par défaut de cette définition de champ comme indiqué dans le tableau précédent. L’un des attributs de champ peut être substitué dans le balisage CAML de l’attribut FieldRef, qui substitue la définition fournie pour le champ lui-même. (L’attribut Type d’un champ ne peut pas être modifié.)

<Property Select="DisplayName"/> permet d’afficher le nom complet d’un champ défini par l’utilisateur.

Dans une énumération d'éléments Fields, l'attribut Name peut être omis. Pour certaines références de champ, les données brutes stockées pour le champ sont accessibles à l’aide de <Column/>.

Certaines propriétés des champs de formulaires et de certains aspects de l’interface utilisateur de création peuvent être rendues à travers l’élément Property, par exemple <Property Select="Description"/> or <Property Select="Type"/>. Ces éléments récupèrent simplement la valeur de n’importe quel attribut de champ ou élément enfant (Property) par son nom.

Outre les types précédents, les champs prédéfinis suivants sont utilisés avec l’élément Field.

Nom	Description
Created	Champ qui contient une valeur DateTime spécifiant l’heure à laquelle l’élément a été créé (en UTC).
CreatedBy	Champ qui contient une valeur Lookup qui fait référence à la table UserInfo et indique l’utilisateur qui a créé l’élément.
Edit	Champ calculé (sans schéma supplémentaire) qui contient un lien hypertexte vers le formulaire de modification d’un élément. Ce champ fait référence à la page qui permet de modifier l’élément et au champ ID qui permet de l’identifier.
ID	Type de champ Counter associé à chaque élément dans chaque liste. L’ID identifie de manière unique l’élément de liste dans les URL et dans les formulaires POST lors de la modification. Spécifier New en tant que valeur de l’attribut ID dans la commande Cmd=Save crée un élément au lieu de modifier un élément actuel.
Modified	Champ qui contient une valeur DateTime spécifiant l’heure à laquelle l’élément a été modifié pour la dernière fois (en UTC). L’heure Modified est également utilisée comme un tri du champ Version. La date de la dernière modification d’un élément est toujours publiée lorsqu'un élément existant est en cours de modification. Si elle ne correspond pas à la date de modification actuelle, le serveur ne parvient pas à effectuer la modification et retourne une erreur à l’utilisateur, en fournissant un lien vers les données actuelles sur le serveur (qui apparaissent dans une nouvelle fenêtre), de sorte que les valeurs publiées peuvent être copiées à partir du formulaire ancien vers le nouveau.
ModifiedBy	Champ qui contient une valeur Lookup de la table UserInfo indiquant le dernier utilisateur ayant modifié l’élément.
Title	Nom générique complet de chaque élément. Il peut avoir un nom complet différent dans différentes listes, mais le même nom de champ interne de Title.Le titre est le texte par défaut à afficher pour les champs Lookup dans les listes.
LinkTitle	Champ calculé qui affiche des liens hypertexte vers des éléments, contenant les textes de titre et générant des URL (et de nouvelles références d’icône) vers les éléments. Il n’existe pas de stockage supplémentaire pour ce champ ; il s’appuie sur les champs d’ID et de titre pour le rendu de son interface utilisateur.

Notes

Les champs retournés dans une énumération Fields sont affectés par le mode d’affichage. Les champs qui sont marqués avec l’attribut Hidden ne sont jamais retournés. Les champs qui sont marqués avec l’attribut ReadOnly ne sont pas retournés si un formulaire est en cours de rendu (si Fields est appelé depuis un élément ListForm). Les champs qui sont marqués avec l’attribut ShowInNewForm ne sont pas retournés dans les modes d’affichage NEW ou PREVIEWNEW. Les champs marqués avec l’attribut ShowInFileDlg ne sont pas retournés lors du rendu du formulaire de boîte de dialogue NewForm.

Exemple

L’exemple suivant utilise l’élément Field pour spécifier les options d’une liste appelée Area.

<Field Type="Choice" BaseType="Text" Name="Area">
  <CHOICES>
    <CHOICE>Views</CHOICE>
    <CHOICE>Site Design</CHOICE>
    <CHOICE>Layouts</CHOICE>
    <CHOICE>Schema Design</CHOICE>
    <CHOICE>Fields</CHOICE>
    <CHOICE>Forms</CHOICE>
    <CHOICE>Projects</CHOICE>
    <CHOICE>Inter-Team Issues</CHOICE>
    <CHOICE>Schedule</CHOICE>
    <CHOICE>Spec</CHOICE>
    <CHOICE>Headcount</CHOICE>
    <CHOICE>Misc</CHOICE>
  </CHOICES>
</Field>