Élément Column (View)

Article
04/08/2023

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

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>

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut	Description
AutoHyperLink	Facultatif Boolean. TRUE pour entourer le texte de `<A>` balises si le texte apparaît comme un lien hypertexte (par exemple, `www.microsoft.com`).
AutoHyperLinkNoEncoding	Facultatif Boolean. TRUE pour entourer le texte de `<A>` balises si le texte apparaît comme un lien hypertexte (par exemple, `www.microsoft.com`), mais sans encodage HTML.
AutoNewLine	Facultatif Boolean. TRUE pour insérer `<BR>` des balises dans le flux de texte et remplacer plusieurs espaces par un espace insécable (` `).
Par défaut	Texte facultatif. Affiche le texte affecté à cet attribut si la valeur retourné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	Facultatif Boolean. TRUE pour convertir des caractères incorporés de façon à ce que qu'ils s'affichent en tant que texte dans le navigateur. En d'autres termes, les caractères qui peuvent être confondus avec des balises HTML sont convertis en entités.
Name	Texte facultatif. Permet à l’élément Column d’être utilisé en dehors du contexte de rendu de champ en fournissant un ID (par exemple, `<Column Name="`ID`"/>`).
ShowField	Texte facultatif. L'attribut ShowField peut prendre la valeur du nom de colonne à afficher. Par défaut, un texte hypertexte de la colonne Titre de l’enregistrement dans la liste externe s’affiche. Mais l'attribut ShowField peut être utilisé pour remplacer cela et afficher un autre champ à partir 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	Facultatif Boolean. TRUE pour supprimer des espaces au début et à la fin de la valeur renvoyée par l'élément.
SubColumnNumber	Entier facultatif.
Urlencode	Facultatif Boolean. TRUE pour convertir des caractères spéciaux, tels que des espaces, au format UTF-8 entre guillemets (par exemple, `%c3%ab` pour les caractères `ë`).
URLEncodeAsURL	Facultatif Boolean. Comme URLEncode, mais TRUE pour spécifier que la chaîne à encoder est un composant de chemin d’accès d’une URL afin que les barres obliques (`/`) ne soient pas encodé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 (<Column/>) vide est utilisé, il est sensible au paramètre actuel de la DisplayMode variable. Le mode d'affichage est défini implicitement en fonction de la commande actuelle utilisée.

Si un affichage ou un élément est affiché, DisplayMode est défini sur Afficher. Si un élément est créé à partir d’un formulaire, DisplayMode est défini sur Nouveau. Si un élément existant est en cours de modification, DisplayMode est défini sur Modifier. La DisplayMode variable peut être remplacée dans la page en la définissant directement, par exemple. <SetVar Name="DisplayMode">Edit</SetVar>

L’utilisation <Column/> de pour afficher un champ de date ou un champ numérique affiche les données dans les paramètres régionaux du serveur, car <Column/> affiche les valeurs numériques selon les règles spécifiques aux paramètres régionaux du serveur.

Partager via