Field, élément (Field)

Article
09/24/2014

Dernière modification : jeudi 20 mai 2010

S’applique à : SharePoint Foundation 2010

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

Définit une colonne de site

<Field
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  AllowDeletion="TRUE" | "FALSE"
  AllowDuplicateValues="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"
  Commas="TRUE" | "FALSE"
  Customization=Text
  Decimals="Integer"
  DefaultListField="TRUE" | "FALSE"
  Description="Text"
  Dir="Text"
  DisplaceOnUpgrade="TRUE" | "FALSE"
  DisplayImage="Text"
  DisplayName="Text"
  DisplayNameSrcField="Text"
  DisplaySize=Integer
  Div="Number"
  EnableLookup="TRUE" | "FALSE"
  ExceptionImage="Text"
  FieldRef="Text"
  FillInChoice="TRUE" | "FALSE"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  ForcedDisplay="Text"
  Format="DateOnly | DateTime | TimeOnly | EventList | ISO8601 | MonthDayOnly | MonthYearOnly | ISO8601Basic | ISO8601Gregorian | ISO8601BasicDateOnly | DropDown | RadioButtons | HyperLink | Image | TRUE | FALSE"
  FromBaseType="TRUE" | "FALSE"
  Group="Text"
  HeaderImage="Text"
  Height="Integer"
  Hidden="TRUE" | "FALSE"
  HTMLEncode="TRUE" | "FALSE"
  ID="Text"
  IMEMode="active | 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"
  List="Text"
  Max="Number"
  MaxLength="Integer"
  Min="Number" 
  Mult="TRUE" | "FALSE"
  Name="Text"
  NegativeFormat="MinusSign" | "Parens"
  Node="Text"
  NoEditFormBreak="TRUE" | "FALSE"
  NumLines="Integer"
  Overwrite="TRUE" | "FALSE"
  OverwriteInChildScopes="TRUE" | "FALSE"
  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="Restrict | Cascade | None"
  RenderXMLUsingPattern="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  RestrictedMode="TRUE" | "FALSE"
  ResultType="Text"
  RichText="TRUE" | "FALSE"
  RichTextMode="Text"
  RowOrdinal="Integer"
  Sealed="TRUE" | "FALSE"
  SeperateLine="TRUE" | "FALSE"
  SetAs="Text"
  ShowAddressBookButton="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"
  Viewable="TRUE" | "FALSE"
  Width="Integer"
  WikiLinking="TRUE" | "FALSE"
  XName="Text">
</Field>

Attributs

Attribut	Description
Aggregation	Text facultatif. Utilisé dans un champ d’agrégation d’un formulaire XML pour spécifier la fonction à appliquer à une collection de valeurs ou d’éléments renvoyés par une expression XPath. Si vous utilisez l’attribut Node pour spécifier une expression XPath qui renvoie une collection de valeurs, vous pouvez aussi inclure un attribut Aggregation qui spécifie l’action à exécuter sur l’ensemble de valeurs qui a été renvoyé. Cette action peut être une fonction d’agrégation ou 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 texte du nœud en texte brut. first Appliquer la promotion et la rétrogradation de propriétés au premier élément de la collection. last Appliquer la promotion et la rétrogradation de 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 de propriétés dans les documents XML, voir Utilisation de types de contenu pour spécifier des propriétés de document XML.
AllowDeletion	Boolean facultatif. TRUE si le champ peut être supprimé.
AllowDuplicateValues	Boolean facultatif. Spécifie si les valeurs dupliquées sont autorisées dans un champ de liste donné. La définition avec la valeur false, ce qui empêche d’entrer des valeurs dupliquées, fait que le champ se comporte réellement comme une clé primaire. True si les valeurs dupliquées sont autorisées dans le champ ; sinon false. La valeur par défaut est true.
AllowHyperlink	Boolean facultatif. TRUE si les liens hypertexte peuvent être utilisés dans le champ.
AllowMultiVote	Boolean facultatif. TRUE si plusieurs réponses sont autorisées dans une enquête.
AppendOnly	Boolean facultatif. Lorsque le contrôle de version est activé dans la liste, TRUE si le texte ne peut être qu’ajouté au texte existant du champ Note.
AuthoringInfo	Text facultatif. Chaîne descriptive affichée dans les pages de modification de champ pour identifier le champ et son objectif ; par exemple, le champ LinkTitle possède les informations sur la création « (lien vers l’élément) ». Cet attribut est généralement utilisé si un champ de même nom existe pour un autre objectif.
BaseType	Facultatif. L’attribut BaseType peut être défini comme Integer, qui stocke les valeurs sous la forme d’entiers, ou comme Text (par défaut), qui stocke les valeurs sous la forme de texte. Vous ne pouvez pas créer de champs choix ayant le type Integer comme type de base.
CalType	Integer facultatif. Spécifie le type de calendrier. Les valeurs possibles sont les suivantes : 16 Ère Saka 15 Lunaire chinois 14 Lunaire japonais et coréen 12 Grégorien (transcription française) 11 Grégorien (transcription anglaise) 10 Grégorien (arabe) 9 Grégorien (français du Moyen-Orient) 8 Hébraïque lunaire 7 Thaï 6 Hijri (arabique lunaire) 5 Coréen (ère Tangun) 4 Ère taïwanaise 3 Japonais (ère impériale) 1 Grégorien 0 Aucun type spécifié
CanToggleHidden	Boolean facultatif. TRUE si le champ peut être masqué au travers de l’interface utilisateur.
ClassInfo	FacultatifText. Spécifie une classe de feuilles de style en cascade (CSS) à utiliser pour le champ de l’affichage de table standard. Si elle est définie, la classe spécifiée est utilisée à la place de la classe ms-vb2 standard.
ColName	Text facultatif. Attribut interne qui définit le mappage du champ avec le nom de stockage physique de ce champ. Il doit s’agir d’un nom valide dans la base de données sous-jacente et qui doit être identique au nom utilisé dans la table de base de données. Si le nom n’est pas spécifié, le serveur génère un nom de colonne qui n’entre pas en conflit avec les noms de colonne existants et qui ne contient que les caractères autorisés par Microsoft SQL Server.
Commas	Boolean facultatif. TRUE si les milliers sont séparés à l’aide de virgules.
Customization	Text facultatif. Offre la possibilité d’ajouter des propriétés personnalisées à des types de champs personnalisés.
Decimals	Integer facultatif. Détermine le nombre de décimales à afficher. La valeur affichée est arrondie à la précision requise ; par exemple, 1,05 est affiché sous la forme 1,1 en cas d’arrondi à la décimale supérieure.
DefaultListField	Boolean facultatif. Obtient une valeur qui spécifie si le formulaire Modifier les propriétés doit être affiché pour un fichier quand celui-ci est téléchargé sur une bibliothèque de documents. True si le champ qui est ajouté à une bibliothèque ne possède pas de formulaire Modifier les propriétés visible ; sinon, false. La valeur par défaut est false.
Description	Text facultatif. Fournit la description proposée dans le formulaire de modification d’une liste si une description de champ est spécifiée. Par défaut, les champs de Microsoft SharePoint Foundation ne possèdent pas de description.
Dir	Text facultatif. Spécifie la direction du texte pour un champ qui prend en charge la lecture bidirectionnelle. Les valeurs possibles sont LTR (de gauche à droite), RTL (de droite à gauche) et none.
DisplaceOnUpgrade	Boolean facultatif. Si une définition de champ existe déjà pour le champ, TRUE pour obliger les mises à jour des propriétés des champs avec les valeurs spécifiées dans cette définition de champ.
DisplayImage	Text facultatif. Spécifie le nom d’une icône affichée pour la colonne.
DisplayName	Text facultatif. Nom affiché pour un champ. Aucune restriction sur l’utilisation des espaces. La longueur maximale est de 255 caractères. La valeur peut être une référence à une ressource au format $Resources:String. Pour plus d’informations, voir Localisation de solutions SharePoint. Le nom complet peut être modifié par l’utilisateur et peut changer après la création du champ initial. Ce nom est utilisé comme en-tête de colonne quand le champ est affiché dans une vue table et comme libellé de formulaire quand le champ est affiché dans un formulaire.
DisplayNameSrcField	Text facultatif. Généralement utilisé pour un champ calculé qui nécessite le même nom qu’un autre champ. Si le champ source est modifié et que le nom complet est changé par un utilisateur, le nom complet du champ est également modifié. Cette chaîne se réfère au nom de l’autre champ.
DisplaySize	Integer facultatif.
Div	Number facultatif. Facteur d’échelle utilisé dans la division avant d’afficher un nombre. Le nombre affiché est N * Mult / Div (arrondi au nombre spécifié par Decimals).
EnableLookup	Boolean facultatif. TRUE pour activer les valeurs de recherche dans le champ.
ExceptionImage	Text facultatif. Utilisé dans un type de champ Recurrence pour spécifier le nom du fichier image à utiliser pour les exceptions.
FieldRef	Text facultatif. Pour un champ de recherche secondaire, spécifie l’ID du champ de recherche principale dont il dépend. La valeur doit être la représentation de chaîne d’un GUID sans accolades.
FillInChoice	Boolean facultatif. TRUE si le champ autorise les utilisateurs à remplir des valeurs pour la colonne.
Filterable	Boolean facultatif. TRUE si le champ peut être filtré.
FilterableNoRecurrence	Boolean facultatif. TRUE si un filtre peut être créé sur le champ d’une vue qui ne développe pas les événements récurrents. Si Filterable contient TRUE, le champ peut être filtré dans toutes les vues, quelle que soit la façon dont FilterableNoRecurrence est défini.
ForcedDisplay	Text facultatif. Spécifie le texte à afficher à la place de la valeur de champ réelle. Cet attribut est utilisé dans les enquêtes pour empêcher que le nom d’utilisateur ne soit affiché.
Format	Text facultatif. Spécifie la mise en forme à utiliser pour les valeurs numériques. Pour les champs date/heure, les valeurs suivantes sont possibles : DateOnly Afficher (et permettre les modifications) uniquement la partie date (la partie heure est définie avec la valeur 12:00 A.M. pour toutes les valeurs modifiées). DateTime Afficher et modifier la date et l’heure du jour (par défaut). ISO8601 Afficher la date et l’heure au format heure ISO8601 converti en format UTC (Coordinated Universal Time) : AAAA-MM-JJTHH: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 Utiliser la forme abrégée des formats date/heure 8601 : AAAAMMJJTHHMMSSZ. Il s’agit du format utilisé pour vCard/iCal. Pour les champs Choix, cet attribut peut être défini avec la valeur Dropdown (par défaut), qui fournit des options de modification via une une sélection de liste déroulante, ou avec la valeur RadioButtons, qui fournit des options via un groupe de cases d’option. Pour les champs URL, cet attribut peut être défini avec la valeur Hyperlink (par défaut), qui affiche l’URL comme balise <A> normale, ou avec la valeur Image, qui affiche l’URL sous la forme <IMG SRC="URL" ALT="Description">.
FromBaseType	Boolean facultatif. Cet attribut est abandonné au profit de l’attribut Sealed.
Group	Text facultatif. Spécifie le groupe de colonnes auquel le champ appartient.
HeaderImage	Text facultatif. Spécifie le nom d’un fichier image à utiliser comme en-tête du champ.
Height	Integer facultatif. Spécifie la hauteur en pixels des images affichées pour les utilisateurs dans la liste d’informations utilisateur.
Hidden	Boolean facultatif. Si la valeur est TRUE, le champ est totalement masqué dans l’interface utilisateur. La définition de ReadOnly avec la valeur TRUE signifie que le champ n’est pas affiché dans les formulaires Nouveau ou Modifier, mais qu’il peut continuer à être inclus dans les affichages.
HTMLEncode	Boolean facultatif. TRUE pour convertir les caractères incorporés de telle sorte qu’ils s’affichent sous forme de texte dans le navigateur ; les caractères susceptibles d’être confondus avec les balises HTML sont convertis en entités.
ID	Text obligatoire. Identifie le champ de façon unique. La valeur doit être la représentation de chaîne d’un GUID contenu au sein d’accolades ({}).
IMEMode	Text facultatif. Spécifie l’ajustement du mode de l’éditeur de méthode d’entrée à utiliser pour le champ. L’éditeur de méthode d’entrée autorise la conversion de séquences de touches d’une langue à une autre quand un système d’écriture possède plusieurs caractères qui peuvent être codés pour le clavier donné. Les valeurs possibles sont les suivantes : auto Non utilisée. Pour spécifier le mode de l’éditeur de méthode d’entrée, définissez la valeur de la propriété IMEMode avec une chaîne vide (""). active Tous les caractères sont saisis dans l’éditeur de méthode d’entrée, mais les utilisateurs peuvent toujours désactiver l’éditeur. inactive Les caractères sont saisis sans l’éditeur de méthode d’entrée, même si les utilisateurs peuvent continuer à activer l’éditeur de méthode d’entrée.
Indexed	Boolean facultatif. TRUE si la colonne est indexée pour une utilisation dans les filtres d’affichage.
IsolateStyles	Boolean facultatif. Pour un champ Text dont l’attribut RichText a la valeur TRUE et dont l’attribut RichTextMode a la valeur FullHtml, cet attribut spécifie qu’un serveur réécrira le code HTML du champ pour s’assurer qu’il n’interférera pas avec l’affichage de la page voisine.
IsRelationship	Boolean facultatif. TRUE si ce champ est renvoyé par la méthode GetRelatedFields() d’une autre liste.
JoinColName	Text facultatif. Cet attribut n’est défini que pour les champs de recherche. Il est très similaire à ColName, si ce n’est qu’il indique le nom de la colonne utilisée dans la jointure SQL (JOIN) entre les listes locale et externe. Ordinairement, cette valeur ne doit pas être personnalisée. Elle n’est actuellement utilisée que dans le schéma du champ de certains champs intégrés ou de type de base pour indiquer les recherches dans la table des URL (DocMd), jointe sur la colonne UrlID.
JoinRowOrdinal	Integer. facultatif. Non destiné à une utilisation directe à partir de votre code.
JoinType	Text facultatif. Spécifie le type d’instruction de jointure (JOIN) utilisé sur le champ. Les valeurs possibles sont INNER, LEFTOUTER et RIGHTOUTER.
LCID	Facultatif Integer. 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 particuliers impliquent le format du symbole euro. Si LCID=-1 (0xFFFFFFF), le symbole euro vient s’ajouter comme préfixe au nombre. Si LCID=-2 (0xFFFFFFE), il vient s’ajouter comme suffixe. Le nombre de chiffres décimaux est égal à 2, même si cette valeur peut être remplacée par l’attribut Decimals du champ. Le symbole monétaire de l’euro est égal à 0x20AC en UCS-2.
List	Text facultatif. Permet d’identifier la liste qui est la cible d’un champ de recherche (Type="Lookup"). Si la liste cible existe déjà, la valeur de l’attribut List doit être la représentation de chaîne du GUID (accolades incluses) qui identifie la liste cible. Si la cible est la même liste que celle à laquelle le champ appartient, vous pouvez spécifier « Auto ». Si la liste cible n’existe pas encore, la valeur de l’attribut List peut être une URL de site Web telle que « Listes/Ma liste », mais uniquement si la liste cible est créée dans la même fonctionnalité que celle qui crée le champ de recherche. Dans ce cas, la valeur de l’attribut List de l’élément Field doit être identique à la valeur de l’attribut Url de l’élément ListInstance qui crée la liste cible.
Max	Number facultatif. Spécifie la valeur maximale autorisée pour le champ.
MaxLength	Valeur de type Integer facultative. Spécifie le nombre maximal de caractères autorisés dans une valeur de champ. Les formulaires d'édition sont ajustés pour permettre l'application de cette valeur, qui est validée sur le client. Si l'utilisateur tente d'entrer plus de caractères que le nombre défini par MaxLength, un message d'erreur s'affiche.
Min	Number facultatif. Spécifie la valeur minimale autorisée pour la champ.
Mult	Boolean facultatif. La valeur TRUE permet à un champ de recherche de contenir plusieurs valeurs. La valeur par défaut est FALSE.
Name	Text obligatoire. Nom interne du champ. Le nom doit être unique par rapport à l’ensemble des champs d’une liste ou d’un site Web. SharePoint Foundation modifie la valeur si nécessaire pour garantir son unicité ; sinon, le nom ne change pas pendant la durée de vie de la définition du champ.
NegativeFormat	Text facultatif. Spécifie comment indiquer les valeurs négatives. Peut être défini avec l’une des valeurs suivantes : MinusSign Utiliser le signe moins (-) comme préfixe. Parens Encadrer entre parenthèses.
Node	Text facultatif. Utilisé dans les formulaires XML, cet attribut est obligatoire pour tous les champs à l’exception des liens d’instructions de traitement et spécifie l’expression XPath d’un nœud promu.
NoEditFormBreak	Boolean facultatif. TRUE pour empêcher qu’un saut de ligne ne soit ajouté entre les champs d’un nouveau formulaire d’élément et ou d’un formulaire de modification de l’élément. Certains types de champs, comme un texte de champ enrichi, fournissent un espacement par défaut, et cet attribut permet de contrôler l’espacement supplémentaire qui en résulte.
NumLines	Integer facultatif. Recommande le nombre de lignes à afficher dans un bloc TEXTAREA pendant la modification. Il s’agit simplement d’une indication d’interface utilisateur clients – il n’existe aucune limite obligatoire sur le nombre de lignes de texte qui peuvent être modifiées.
Overwrite	Boolean facultatif. Spécifie si la définition de champ d’un nouveau champ activé sur un site (SPWeb) remplace celle d’un champ existant, lorsque le nouveau champ a le même ID de champ que la champ existant. True si le nouveau champ remplace le champ existant ayant le même ID de champ ; sinon, false. La valeur par défaut est false. Notez, cependant, que si le champ existant est en lecture seule, ou s’il est de type sealed, il ne sera pas remplacé par le champ activé, même si cet attribut a la valeur true.
OverwriteInChildScopes	Boolean facultatif. Indique si une définition de champ spécifiée doit être remplacée lorsque vous configurez le champ dans une collection de sites et que cette définition de champ existe déjà dans le site Web enfant de cette collection de sites. True si la définition de champ doit être remplacée ; sinon false. La valeur par défaut est false.
Percentage	Boolean facultatif. TRUE si la valeur est affichée sous forme de pourcentage, à savoir un nombre multiplié par 100 avec ajout du symbole pourcentage (%).
PIAttribute	Text facultatif. Spécifie l’attribut de l’instruction de traitement du document (définie par l’attribut PITarget) à, utiliser comme valeur de colonne. Utilisé pour la promotion et la rétrogradation de propriétés dans les documents XML. Si vous spécifiez l’attribut PIAttribute, vous devez aussi spécifier l’attribut PITarget. Pour plus d’informations sur la façon dont les attributs Node, PIAttribute, PITarget, Primary PIAttribute 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.
PITarget	Text facultatif. Spécifie l’instruction de traitement du document où la valeur de colonne est stockée dans les documents de ce type de contenu. Utilisé pour la promotion et la rétrogradation de 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 la façon dont les attributs Node, PIAttribute, PITarget, Primary PIAttribute 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.
PrependId	Boolean facultatif. Utilisé par les champs de recherche qui peuvent avoir plusieurs valeurs. Spécifiez TRUE pour afficher l’ID d’élément d’un élément cible ainsi que la valeur du champ cible dans les formulaires Modifier et Nouveau.
Presence	Boolean facultatif. TRUE si les informations utilisateur sont présentes pour le champ.
PrimaryKey	Boolean facultatif. TRUE si le champ est la clé primaire des relations entre la liste et une autre liste.
PrimaryPIAttribute	Text facultatif. Utilisé pour la promotion et la rétrogradation de propriétés dans les documents XML. Spécifie un attribut de remplacement dans l’instruction de traitement du document, définie par l’attribut PrimaryPITarget, à utiliser comme valeur de colonne. Si vous spécifiez l’attribut PrimaryPIAttribute, vous devez également spécifier l’attribut PrimaryPITarget. En cas de spécification, SharePoint Foundation utilise ces valeurs avant celles spécifiées dans les attributs PITarget et PIAttribute. Pour plus d’informations sur la façon dont les attributs Node, PIAttribute, PITarget, Primary PIAttribute 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.
PrimaryPITarget	Text facultatif. Spécifie une autre instruction de traitement de document dans laquelle la valeur de 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. En cas de spécification, SharePoint Foundation utilise ces valeurs avant celles spécifiées dans les attributs PITarget et PIAttribute. Pour plus d’informations sur la façon dont les attributs Node, PIAttribute, PITarget, Primary PIAttribute 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.
ReadOnly	Boolean facultatif. Si la valeur est TRUE, le champ n’est pas affiché dans les formulaires Nouveau ou Modifier, mais peut être inclus dans les affichages. En outre, la définition de ReadOnly avec la valeur TRUE masque le champ dans les pages Paramètres du site pour gérer les colonnes de site et les types de contenu. La définition de l’attribut Hidden avec la valeur TRUE masque complètement le champ dans l’interface utilisateur. Si vous n’incluez pas cet attribut, SharePoint Foundation traite la colonne comme si l’attribut avait la valeur False.
ReadOnlyEnforced	Boolean facultatif. TRUE pour spécifier que l’utilisateur ne peut modifier le champ par aucun moyen et que le champ ne peut être changé que par le système.
RelationshipDeleteBehavior	Text facultatif. Spécifie une contrainte de suppression pour un champ de recherche. Pour plus d’informations, voir l’énumération SPRelationshipDeleteBehavior. Pour une colonne de site, la valeur ne doit être ni Cascade ni Restrict. Elle peut être None (par défaut), ou l’attribut peut être omis. Si vous spécifiez une valeur autre que None, vous devez également spécifier TRUE pour l’attribut Indexed et FALSE pour l’attribut Mult.
RenderXMLUsingPattern	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 à partir du modèle d’affichage du champ calculé, et non sur la valeur de colonne de la première référence de champ non calculé sur laquelle est fondé le champ calculé. 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’a pas la valeur TRUE, seule la première référence de champ, largeur, est affichée. Si la valeur est TRUE, le format largeur x hauteur est affiché.
Required	Boolean obligatoire. Si la valeur est TRUE, le champ ne doit pas se voir affecter une valeur vide. Si une valeur de champ non vide n’est pas fournie dans une publication de formulaire, le texte standard du champ obligatoire ou un message explicitement spécifié (à savoir, via les balises <ErrorText> tags) s’affiche 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	Boolean facultatif. TRUE pour interdire au champ Note de contenir une mise en forme améliorée de texte enrichi, telle que images, tableaux ou liens hypertexte, ou de coller dans le champ un texte mis en forme.
ResultType	Text facultatif. Spécifie le type de données des valeurs renvoyées depuis le champ.
RichText	Boolean facultatif. TRUE si le champ affiche une mise en forme de texte enrichi.
RowOrdinal	Integer facultatif. Spécifie l’emplacement de base de données pour le champ.
Sealed	Boolean facultatif. La définition de cet attribut avec la valeur TRUE pour un champ marque le champ comme impossible à supprimer. La page Modifier la colonne n’a pas de bouton Supprimer. Les utilisateurs ne peuvent pas supprimer le champ.
SeparateLine	Boolean facultatif. Utilisé en interne pour prendre en charge la restitution d’un champ (par exemple, Notes ou Commentaire) sur une ligne distincte. Cet attribut n’est pas destiné à une utilisation publique.
SetAs	Non destiné à une utilisation directe à partir de votre code.
ShowAddressBookButton	Non destiné à une utilisation directe à partir de votre code.
ShowField	Text facultatif. Quand l’attribut Type est « Recherche », la valeur de l’attribut ShowField spécifie le nom interne du champ cible à rechercher. Si aucune valeur n’est spécifiée, le texte du lien hypertexte du champ Titre de l’enregistrement de la liste cible s’affiche. Les types de champ suivants sont autorisés comme cible d’un champ de recherche : Counter, DateTime, Number et Text. Le type de champ Computed peut être une cible si les recherches sont activées. Pour plus d’information, voir la propriété EnableLookup de la classe SPFieldComputed. Le type de champ Calculated peut être une cible si la sortie correspond à du texte. Pour plus d’informations, voir la propriété OutputType de la classe SPFieldCalculated.
ShowInDisplayForm	Boolean facultatif. TRUE pour afficher le champ du formulaire d’affichage en vue de voir l’élément.
ShowInEditForm	Boolean. TRUE pour afficher le champ du formulaire en vue de modifier l’élément.
ShowInFileDlg	Boolean facultatif. Cet attribut n’est valide que pour les champs des schémas de bibliothèque de documents. Si la valeur est FALSE, le champ n’apparaît pas dans la boîte de dialogue Propriétés qui permet d’enregistrer les formulaires et qui s’affiche lors de l’enregistrement à partir des applications clientes. Par exemple, le champ Titre possède cet attribut, car celui-ci est défini directement dans le document enregistré dans la bibliothèque de documents.
ShowInListSettings	Boolean facultatif. TRUE pour afficher la colonne sur la page de personnalisation des paramètres de liste.
ShowInNewForm	Boolean facultatif. Si la valeur est FALSE, le champ n’apparaît pas dans une énumération Fields lorsque le mode d’affichage a la valeur New. Les champs avec ce paramètre n’apparaissent pas dans la page Nouvel élément par défaut d’une liste donnée. Ce paramètre est utilisé en particulier pour masquer les champs sur la page de téléchargement des documents sur la bibliothèque de documents.
ShowInVersionHistory	Boolean facultatif. TRUE pour afficher la colonne sur la page d’affichage des versions des éléments de liste.
ShowInViewForms	Boolean facultatif. TRUE pour spécifier que le champ s’affiche dans les pages utilisées pour visualiser les données de liste.
Sortable	Boolean facultatif. TRUE si les valeurs du champ peuvent être triées.
SourceID	Valeur Text facultative. 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	Text facultatif. Contient un nom interne du champ qui peut ne pas être unique au sein d’une collection de champs. Cependant, contrairement à l’attribut Name, qui peut être modifié pour assurer son unicité, la valeur de l’attribut StaticName est assignée au champ exactement comme vous l’avez définie. Vous pouvez par la suite utiliser cette valeur dans le code pour obtenir une référence au champ en appelant la méthode TryGetFieldByStaticName.
StorageTZ	Spécifie comment les valeurs date/heure sont stockées. Quand StorageTZ a la valeur UTC, la valeur date/heure est gérée au format UTC. Pour indiquer qu’une valeur date/heure fait référence à une heure « abstraite », ce qui signifie que la valeur date/heure est stockée dans la base de données telle qu’elle a été entrée par l’utilisateur sans conversion ou stockage du fuseau horaire local, omettez l’attribut StorageTZ.
StripWS	Boolean facultatif. TRUE si les espaces blancs sont supprimés en début et en fin des valeurs des champs.
SuppressNameDisplay	Boolean facultatif. TRUE pour ne pas afficher le nom de l’utilisateur dans un champ User.
TextOnly	Boolean facultatif. Si la valeur est TRUE, le champ ne peut contenir que des valeurs Text.
Title	Facultatif Text. Contient l’intitulé du champ affiché dans l’interface utilisateur.
Type	Text obligatoire. Type de données du champ (à moins que l’élément Field ne soit un enfant de ProjectedFields). Remarque Dans la version préliminaire de Microsoft SharePoint Foundation 2010, l’attribut Type possède une signification différente et une seule valeur possible (« Recherche ») quand il est enfant de ProjectedFields. Voir ProjectedFields, élément (View) pour plus d’informations sur cette utilisation de Type. SharePoint Foundation inclut les types de données suivants par défaut : AllDayEvent Spécifie une journée entière. Correspond au type de données SQL bit. Attachments Stocke les URL pour les pièces jointes. Correspond au type de données SQL bit. Boolean Utilisé pour stocker une valeur TRUE/FALSE (stockée dans la base de données sous la forme 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 à partir d’autres colonnes. Correspond au type de données SQL sql_variant et représenté par la classe SPFieldCalculated. Choice Permet à l’utilisateur de spécifier un ensemble prédéterminé de valeurs qui peuvent être utilisées pour entrer des données dans le champ. Les types Choice et Lookup sont les champs les plus importants pour le tri et le regroupement. Les attributs BaseType et Format peuvent être utilisés pour les champs Choix. Ce champ peut être trié et regroupé. Quand une valeur est fournie pour une option de choix, cette valeur est utilisée comme valeur soumise pour la sélection du champ. Quand aucune valeur n’est fournie, ce choix est soumis comme valeur texte du choix. Dans tous les cas, la valeur texte du choix est ce qui s’affiche dans l’interface utilisateur (texte de liste déroulante ou de case d’option). L’ordre dans lequel les choix apparaissent dans l’interface utilisateur de modification est toujours celui où les éléments sont spécifiés au sein de l’élément CHOICES. Utilisez le type MultiChoice pour spécifier un champ Choice qui implémente les cases à cocher et permet à l’utilisateur de sélectionner plusieurs valeurs. Correspond au type de données SQL nvarchar et représenté par la classe SPFieldChoice. Computed Spécifie un champ qui dépend d’un autre champ quant à son contenu. Par exemple, un champ LinkTitleNoMenu revient à entourer une valeur de champ Titre avec 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 Généralement n’est utilisé que pour le champ ID interne. Sa valeur, de type entier, est définie automatiquement de façon à être unique par rapport à tout autre élément de la liste courante. Le type Counter est toujours en lecture seule et ne peut pas être défini à travers une publication de formulaire. Ce champ peut être trié, mais non regroupé. Correspond au type de données SQL int. CrossProjectLink Utilisé pour connecter un événement d’une liste SharePoint avec un site d’espace de travail de réunion ; se réfère spécifiquement au type de champ de la case à cocher utilisée dans les formulaires d’élément Nouveau et Modifier pour créer un site d’espace de travail de réunion de l’élément. Correspond au type de données SQL bit et représenté par la classe SPFieldCrossProjectLink. Currency Permet d’entrer une valeur monétaire. Chaque champ monétaire est lié à la devise des paramètres régionaux. Sur tous les autres plans, il est traité comme le type de champ Number. Utilisez l’attribut LCID pour indiquer une devise de paramètre régional spécifique. 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 représenté par la classe SPFieldCurrency. DateTime Permet le stockage d’une date ou d’une heure complète. Utilisez l’attribut Format pour spécifier la mise en forme de la date, et utilisez l’attribut StorageTZ pour déterminer comment les valeurs date/heure sont stockées. Ce champ peut être trié et regroupé. Pour le mode Affichage, l’ordre de la mise en forme des données dérive des paramètres régionaux (« M/J/A » ou « J/M/A »). En mode Modifier (ou en mode Nouveau pour la valeur d’élément Default), les dates/heures sont affichées au format universel : M/J/A hh:mm am/pm. Correspond au type de données SQL datetime et représenté par la classe SPFieldDateTime. File Contient un fichier. 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 représenté par la classe SPFieldRatingScale. Guid Autorise les GUID. Correspond au type de données SQL uniqueidentifier. Integer Autorise les valeurs d’entiers positifs ou négatifs. 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 de façon très similaire à un champ Choice, si ce n’est que les options disponibles proviennent d’une autre liste au lieu de se présenter sous forme d’une sélection de valeurs codée en dur. Les attributs List et ShowField peuvent être utilisés pour les 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 représenté par la classe SPFieldLookup. LookupMulti Champ Lookup qui peut contenir plusieurs valeurs. Type parent : Lookup. ModStat Contient le statut d’approbation du contenu. Les valeurs possibles incluentApproved (par défaut), Rejected et Pending (stockées respectivement dans la base de données sous la forme 0, 1 ou 2). Correspond au type de données SQL int. MultiChoice Spécifie un champ Choice qui implémente les cases à cocher et permet à l’utilisateur de sélectionner plusieurs valeurs. Correspond au type de données SQL ntext et représenté par la classe SPFieldMultiChoice. MultiColumn Champ Note qui émule un champ contenant plusieurs valeurs. Pour obtenir un exemple de type de champ multicolonne, voir Procédure : créer une définition de type de champ personnalisé. Pour plus d’informations sur les champs multicolonnes, voir Classes de champ multicolonne personnalisées. Type parent : Note. Note Permet aux utilisateurs d’entrer plusieurs lignes de texte. Ce champ ne peut être ni trié ni regroupé. Tout le texte est défini comme simples caractères ASCII sans balisage HTML. Tout ce qui s’apparente à du balisage HTML ou à une URL est simplement placé entre guillemets (par exemple, Server.HTMLEncode) pour s’apparenter à du texte simple. Le contrôle de modification du format est un simple bloc TEXTAREA. Utilisez l’attribut NumLines pour spécifier le nombre de lignes à afficher. Correspond au type de données SQL ntext et représenté par la classe SPFieldMultiLineText. Number Permet d’entrer un nombre à virgule flottante. Ce champ peut être trié et regroupé. Les nombres entrés sont analysés selon les paramètres régionaux courants relatifs aux virgules décimales et aux séparateurs de milliers. Les nombres négatifs peuvent être indiqués en étant placés entre parenthèses ou à l’aide du symbole moins (-). Les attributs suivants peuvent être utilisés en liaison avec 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 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 définir et modifier le modèle de récurrence d’un élément dans une liste d’événements. Correspond au type de données SQL bit. Text Simple ligne de texte entrée dans une zone d’édition. Ce champ peut être trié et regroupé. Utilisez l’attribut MaxLength pour définir le nombre maximal de caractères autorisé. Correspond au type de données SQL nvarchar et représenté par la classe SPFieldText. ThreadIndex Contient l’ID qui indique la position relative d’un message au sein d’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 de vues telles que les discussions à thème. Une liste peut contenir un colonne de threading, mais une interface utilisateur particulière est générée en cas d’utilisation. (Le champ n’est jamais affiché comme champ modifiable standard d’un formulaire ou d’une colonne normale d’une vue.) En cas de tri sur un champ de threading, un récapitulatif prétrié de tous les enregistrements d’une relation parent-enfant est renvoyée. L’opération est effectuée en enregistrant la concaténation de la date de création et du numéro d’ID de tous les enregistrements parents d’un enregistrement particulier. Correspond au type de données SQL varchar. URL Utilisé pour créer un lien hypertexte de forme libre. Un champ URL est affiché comme <A HREF="URL">Description</A>. Si aucune description n’est fournie, le champ apparaît comme <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 du serveur. De cette façon, toute URL locale au serveur peut être mise à jour au travers d’une correction de lien en cas de déplacement de destination. Quand un enregistrement avec un champ URL en son sein est supprimé, l’enregistrement référencé correspondant de la table des URL est également supprimé. Le champ peut être à la fois trié et regroupé. (Le tri est défini selon la description textuelle plutôt que selon le contenu de l’URL ; si aucune description n’est fournie, le tri est identique à un tri sur une zone vierge.) Quand Type a la valeur URL, l’attribut LinkType peut être utilisé pour spécifier le type de lien. Correspond au type de données SQL nvarchar et représenté par la classe SPFieldUrl. User Champ Lookup qui référence la table de base de données UserInfo. Corresponds au type de données SQL int et 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 le statut du flux de travail tel que représenté par l’énumération SPWorkflowStatus. Correspond au type de données SQL nvarchar.
UniqueId	Text facultatif. Non destiné à une utilisation directe depuis votre code.
UnlimitedLengthInDocumentLibrary	Boolean facultatif. TRUE pour permettre une longueur de champ illimité dans les bibliothèques de documents.
URLEncode	Boolean facultatif. TRUE pour convertir les caractères spéciaux, tels que les espaces, au format UTF-8, par exemple, %c3%ab pour le caractère ë.
URLEncodeAsURL	Boolean facultatif. Comme URLEncode, mais TRUE pour spécifier que la chaîne à coder un composant de chemin d’accès d’une URL, de façon à ce que les barres obliques inverses (« / ») ne soient pas codées.
UserSelectionMode	Facultatif Text. Spécifie si seuls les noms des utilisateurs individuels peuvent être sélectionnés dans un champ utilisateur d’un formulaire d’élément, ou si les noms des groupes et des individus peuvent être sélectionnés ensemble. Les valeurs possibles sont les suivantes : 0 - Seuls les noms des individus peuvent être sélectionnés. 1 - Les noms des individus et des groupes peuvent être sélectionnés.
UserSelectionScope	Integer facultatif. Spécifie une étendue pour la sélection des noms d’utilisateur dans un champ utilisateur d’un formulaire d’élément. Si la valeur est égale à 0, il n’existe aucune restriction à un groupe SharePoint. Si la valeur est supérieure à 0, la sélection utilisateur est limitée aux membres du groupe SharePoint dont l’ID équivaut à la valeur spécifiée.
Viewable	Boolean facultatif. TRUE pour spécifier que le champ est ajouté à l’affichage par défaut. La valeur par défaut est TRUE.
Width	Integer facultatif. Spécifie la largeur en pixels des images affichées pour les utilisateurs dans la liste d’informations utilisateur.
WikiLinking	Boolean facultatif. TRUE pour spécifier que les liens Wiki, qui figurent sous la forme de crochets doubles ([[…]]), sont traduits en liens HTML, qui utilisent la balise <a>.
XName	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

Éléments parents

Éléments

Remarques

Important

Lors de la définition d’un champ personnalisé, vous devez spécifier les attributs ID, Type, Name, Display Name et Group pour que le champ s’affiche correctement dans Microsoft SharePoint Foundation. La saisie semi-automatique dans Microsoft Visual Studio indique par erreur que vous n’avez besoin que de trois de ces attributs, quand, de fait, les cinq attributs sont obligatoires.

Exemple

L’exemple suivant illustre un manifeste d’élément d’une fonctionnalité qui crée trois colonnes de site.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">

  <Field ID="{060E50AC-E9C1-4D3C-B1F9-DE0BCAC300F6}"
         Name="Amount"
         DisplayName="Amount"
         Type="Currency"
         Decimals="2"
         Min="0"
         Required="FALSE"
         Group="Financial Columns" />

  <Field ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}"
         Name="CostCenter"
         DisplayName="Cost Center"
         Type="Choice"
         Required="FALSE"
         Group="Financial Columns">
    <CHOICES>
      <CHOICE>Administration</CHOICE>
      <CHOICE>Information</CHOICE>
      <CHOICE>Facilities</CHOICE>
      <CHOICE>Operations</CHOICE>
      <CHOICE>Sales</CHOICE>
      <CHOICE>Marketing</CHOICE>
    </CHOICES>
  </Field>

  <Field ID="{1511BF28-A787-4061-B2E1-71F64CC93FD5}"
         Name="DateOpened"
         DisplayName="Date Opened"
         Type="DateTime"
         Format="DateOnly"
         Required="FALSE"
         Group="Financial Columns">
    <Default>[today]</Default>
  </Field></Elements>

Voir aussi

Partager via

Field, élément (Field)

Attributs

Éléments enfants

Éléments parents

Remarques

Exemple

Voir aussi

Référence

Concepts

Autres ressources

Ressources supplémentaires