Partager via


Column, élément (View)

Dernière modification : samedi 3 avril 2010

S’applique à : SharePoint Foundation 2010

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

Renvoie la valeur des données brutes pour un champ particulier, par opposition à la version mise en forme fournie par l'élément Field. Dans le cas d'un champ Lookup, Column renvoie la valeur locale (numéro d'ID de la liste qui fait référence à une autre liste), alors que l'élément LookupColumn renvoie les données de la table source contenant une clé étrangère.

<Column
  AutoHyperLink = "TRUE" | "FALSE"
  AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
  AutoNewLine = "TRUE" | "FALSE"
    Default = "Text"
  Format="DateTime"
    HTMLEncode = "TRUE" | "FALSE"
    Name = "Text"
    ShowField = "Text" 
    StripWS = "TRUE" | "FALSE"
  SubColumnNumber = Integer
    URLEncode = "TRUE" | "FALSE"
    URLEncodeAsURL = "TRUE" | "FALSE">
</Column>

Attributs

Attribut

Description

AutoHyperLink

Valeur de type Boolean facultative. Lorsque la valeur est TRUE, permet de délimiter du texte avec les balises <A> si le texte équivaut à un lien hypertexte (par exemple www.microsoft.com).

AutoHyperLinkNoEncoding

Valeur de type Boolean facultative. Lorsque la valeur est TRUE, permet de délimiter du texte avec les balises <A> si le texte équivaut à un lien hypertexte (par exemple www.microsoft.com) mais sans codage HTML.

AutoNewLine

Valeur de type Boolean facultative. Lorsque la valeur est TRUE, permet d'insérer les balises <BR> dans le flux de texte et de remplacer plusieurs espaces par un espace insécable (&nbsp;).

Default

Valeur de type Text facultative. Affiche le texte assigné à cet attribut si la valeur renvoyée par une sélection est une chaîne vide ("").

Format

Valeur de type Text facultative. Contrôle le format des dates pour les champs de date. Les formats pris en charge sont les suivants : DateTime, DateOnly, TimeOnly, ISO8601, ISO8601Basic et ISO8601Gregorian.

HTMLEncode

Valeur de type Boolean facultative. Lorsque la valeur est TRUE, permet de convertir les caractères incorporés de sorte qu'ils s'affichent sous forme de texte dans le navigateur. En d'autres termes, les caractères susceptibles d'être confondus avec des balises HTML sont convertis en entités.

Name

Valeur de type Text facultative. Permet à l'élément Column d'être utilisé hors du contexte de rendu du champ en fournissant un ID (par exemple <Column Name="ID"/>).

ShowField

Valeur de type Text facultative. L'attribut ShowField peut être défini en fonction du nom de colonne à afficher. Par défaut, un lien hypertexte de la colonne Title de l'enregistrement provenant de la liste externe est affiché. Toutefois, l'attribut ShowField peut être utilisé en remplacement afin d'afficher un autre champ de la liste externe.

Les types de données suivants sont autorisés en tant que cibles d'un attribut ShowField : Text, Choice et Counter.

StripWS

Valeur de type Boolean facultative. Lorsque la valeur est TRUE, permet de supprimer les espaces blancs situés au début et à la fin de la valeur renvoyée par l'élément.

SubColumnNumber

Valeur de type Integer facultative.

URLEncode

Valeur de type Boolean facultative. Lorsque la valeur est TRUE, permet de convertir les caractères spéciaux, par exemple les espaces, au format UTF-8 entre guillemets (par exemple %c3%ab pour le caractère ë).

URLEncodeAsURL

Valeur de type Boolean facultative. Semblable à URLEncode, mais lorsque la valeur est TRUE, permet de spécifier que la chaîne à coder est un composant de chemin d'accès d'une URL afin que les barres obliques (« / ») ne soient pas codées.

Éléments enfants

Aucun

Éléments parents

Nombreux

Occurrences

Minimum : 0

Maximum : pas de limite (1 dans Limit)

Remarques

Notez que lorsqu'un élément Column vide (<Column/>) est utilisé, il varie en fonction du paramètre actuel de la variable DisplayMode. Le mode d'affichage est défini implicitement en fonction de la commande actuelle utilisée. Si un affichage ou un élément est visible, DisplayMode a la valeur Display. Si un élément est créé à partir d'un formulaire, DisplayMode a la valeur New. Si un élément existant est en cours de modification, DisplayMode a la valeur Edit. Vous pouvez substituer la variable DisplayMode dans la page en la définissant directement, par exemple, <SetVar Name="DisplayMode">Edit</SetVar>.

L'utilisation de <Column/> pour afficher un champ de date ou un champ numérique entraîne l'affichage des données en fonction des paramètres régionaux du serveur, car <Column/> affiche les valeurs numériques conformément aux règles spécifiques aux paramètres régionaux du serveur.

Voir aussi

Référence

Column2, élément (View)

Field, élément (affichage)

LookupColumn, élément (View)