Row, élément (dsQueryResponse)

Article
04/08/2023

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

Représente une ligne de données dans la liste. Les champs et les propriétés de métadonnées de l’élément de liste que la ligne contient sont représentés par des attributs de l’élément Row. Certains champs, suivant leur type de données, peuvent être représentés par des attributs supplémentaires qui présentent la valeur du champ dans un format différent.

<Row
  Attachments="Integer"
  ContentTypeId="GUID"
  File_x0020_Type="String"
  FileLeafRef="String"
  FileLeafRef.Name="String"
  FileLeafRef.Suffix="String"
  FSObjType="Integer"
  HTML_x0020_File_x0020_Type.File_x0020_Type.mapall="String"
  HTML_x0020_File_x0020_Type.File_x0020_Type.mapcon="String"
  HTML_x0020_File_x0020_Type.File_x0020_Type.mapico="String"
  ID="Integer"
  PermMask="Hex"
  some_field="type appropriate to the field"
  some_booleanField.Value="Integer"
  some_date_time_field.ifnew="Integer"
  some_date_time_field.="unlocalized DateTime"
  some_date_time_field.DateOnly="date"
  some_date_time_field.TimeOnly="time"
  some_date_time_field.ISO8601="ISO8601 compliant DateTime"
  some_date_time_field.MonthDayOnly="month and day"
  some_date_time_field.MonthYearOnly="month and year"
  some_user_field="String"
  some_user_field.id="Integer"
  some_user_field.title="String"
  some_user_field.span="String"
  some_url_field.desc="String"
/>

Éléments et attributs

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

Attributs

Attribut	Description
Pièces jointes	Obligatoire. 1 si l’élément de liste possède une ou plusieurs pièces jointes ; sinon, 0.
ContentTypeId	Obligatoire. GUID du type de contenu de l’élément de liste au format Ox GUID_without_hyphens.
File_x0020_Type	Obligatoire, mais ignoré si la liste n’est pas une bibliothèque de documents. Type de fichiers dans une bibliothèque de documents. Chaîne vide lorsque la liste n’est pas une bibliothèque de documents.
FileLeafRef	Obligatoire, mais ignoré si la liste n’est pas une bibliothèque de documents. URL relative de serveur du document. Il s’agit du nom du dossier, suivi `"_."`de , suivi du nom de fichier. Par exemple, `QuarterlySummaries_.Quarter1.docx`. Cette valeur d’attribut est la concaténation des valeurs de l’attribut FileLeafRef.Name et de l’attribut FileLeafRef.Suffix avec un `"."` caractère de séparation.
FileLeafRef.Name	Obligatoire, mais ignoré si la liste n’est pas une bibliothèque de documents. Nom du dossier qui contient le document, suivi d’un trait de soulignement ; par exemple, `QuarterlySummaries_.`
FileLeafRef.Suffix	Obligatoire, mais ignoré si la liste n’est pas une bibliothèque de documents. Nom du fichier de document ; par exemple, `Quarter1.docx`.
FSObjType	Obligatoire. 1 si l’élément de liste est un dossier ; sinon, 0.
HTML_x0020_File_x0020_Type.File_x0020_Type.mapall	Facultatif. Valeur retournée par un appel de la fonction MapToAll pendant la transformation XSLT. Pour plus d’informations, voir MapToAll, élément (View) et Fonctions d’extension de composant WebPart Vue de données SharePoint dans l’espace de noms ddwrt.
HTML_x0020_File_x0020_Type.File_x0020_Type.mapcon	Facultatif. Valeur retournée par un appel de la fonction MapToControl pendant la transformation XSLT. Pour plus d’informations, consultez MapToControl(SPWeb, String, String),élément MapToControl (View) et Fonctions d’extension de composant WebPart Vue de données SharePoint dans l’espace de noms ddwrt.
HTML_x0020_File_x0020_Type.File_x0020_Type.mapico	Facultatif. Valeur retournée par un appel de la fonction MapToIcon pendant la transformation XSLT. Pour plus d’informations, voir Icon(), Élément MapToIcon (View) et Fonctions d’extension de composant WebPart Vue de données SharePoint dans l’espace de noms ddwrt.
ID	Obligatoire. ID de l’élément de liste.
Masque perm	Masque d’autorisations pour l’élément de liste.
some_field	Obligatoire pour chaque champ non masqué dans l’élément de liste. Pour chaque champ de ce type, il existe un attribut qui porte le même nom que le nom interne du champ.
some_field	Facultatif. Les types de champs devise, nombre et recherche dans SharePoint Foundation peuvent avoir une mise en forme de bas niveau avant même l’application d’une mise en forme HTML. Par exemple, une valeur monétaire négative est placée entre parenthèses. L’attribut de chaque champ de ce type est immédiatement suivi d’un autre attribut portant le même nom, auquel un `"."` caractère est ajouté. Cet attribut fournit la valeur du champ sous forme de données brutes non mises en forme. Par exemple, une valeur monétaire négative est suivie d’un signe moins (`"-"`) et n’est pas entre parenthèses.
some_booleanField. Valeur	Facultatif. Chaque attribut booléen de l’élément de liste est suivi d’un autre attribut portant le même nom, auquel `".Value"` est ajouté. Cet attribut donne la forme brute non localisée de la valeur de champ (1 ou 0), tandis que l’attribut principal du champ booléen donne la valeur relativisée aux paramètres régionaux du site web.
some_date_time_field.ifnew	Facultatif. 1 si la valeur de date et heure est suffisamment récente pour définir l’élément de liste comme nouveau ; sinon, 0. Cet attribut apparaît uniquement si l’some_date_time_field est « Created_x0020_Date ».
some_date_time_field	Facultatif. S’il existe un attribut pour un champ datetime dont la valeur est localisée, il existe également un attribut portant le même nom, auquel un `"."` caractère est ajouté. Cet attribut fournit la valeur brute d’un champ datetime stocké dans la base de données de contenu au format ISO8601.
some_date_time_field. DateOnly	Facultatif. Valeur d’un champ DateTime avec uniquement la date. Utilisé uniquement sur les listes liées au blog.
some_date_time_field. TimeOnly	Facultatif. Valeur d’un champ DateTime avec uniquement l’heure de la journée. Utilisé uniquement sur les listes liées au blog.
some_date_time_field. ISO8601	Facultatif. Valeur d’un champ DateTime mis en forme conformément à LA norme ISO8601. Utilisé uniquement sur les listes liées au blog.
some_date_time_field. MonthDayOnly	Facultatif. Valeur d’un champ DateTime avec uniquement le mois et le jour du mois. Utilisé uniquement sur les listes liées au blog.
some_date_time_field. MonthYearOnly	Facultatif. Valeur d’un champ DateTime avec uniquement le mois et l’année. Utilisé uniquement sur les listes liées au blog.
some_user_field.id	Facultatif. Si un attribut représente un champ de type Utilisateur, il existe un autre attribut portant le même nom, auquel `".id"` est ajouté. Il s’agit du numéro d’IDENTIFICATION relatif du site de l’utilisateur.
some_user_field.title	Facultatif. Si un attribut représente un champ de type Utilisateur, il existe un autre attribut portant le même nom, auquel `".title"` est ajouté. Il s’agit du nom de l’utilisateur, par exemple « Michiyo Sato ». Notez que la valeur de l’attribut principal, some_user_field, est le balisage d’étendue HTML pour l’utilisateur, y compris, par exemple, les informations de présence. Consultez l’extrait de code sous le tableau pour obtenir un exemple.
some_user_field.span	Facultatif. Si un attribut représente un champ de type Utilisateur, il existe un autre attribut portant le même nom, auquel `".span"`est ajouté. Il s’agit d’une version plus simple du balisage HTML pour l’utilisateur. Consultez l’extrait de code sous le tableau pour obtenir un exemple.
some_url_field.desc	Facultatif. Si un attribut représente un champ d’URL, il existe un autre attribut portant le même nom, auquel est ajouté .desc. Cela fournit une description de l’URL.

Ce balisage est utilisé pour afficher le champ lorsque l’indicateur FreeForm de la propriété ListViewWebPart.ViewFlags n’est pas défini ; sinon, la valeur de l’attribut some_user_field.span est utilisée.

<span class="ms-imnSpan">
  <a href='javascript:;' onclick='IMNImageOnClick(event);return false;' class='ms-imnlink'>
    <img name='imnmark' class='ms-imnImg' title='' border='0' height='12' width='12'
         src='/_layouts/images/blank.gif'
         alt='No presence information'
         sip='MichiyoS@Contoso.com'
         id='imn_1,type=smtp' />
  </a>
  <a onclick="GoToLink(this);return false;" href="/sites/Contoso/_layouts/userdisp.aspx?ID=1">Michiyo Sato</a>
</span>

Ce balisage est utilisé pour afficher le champ lorsque l’indicateur FreeForm de la propriété ListViewWebPart.ViewFlags est défini ; sinon, la valeur de l’attribut some_user_field.title est utilisée.

<nobr>
  <span>
    <a onclick="GoToLink(this);return false;" href="/sites/Contoso/_layouts/userdisp.aspx?ID=1">Michiyo Sato</a>
    <img border="0" height="1" width="3" src="/_layouts/images/blank.gif"/><a href='javascript:;' onclick='IMNImageOnClick(event);return false;' class='ms-imnlink'>
    <img name='imnmark' class='ms-imnImg' title='' border='0' height='12' width='12'
         src='/_layouts/images/blank.gif'
         alt='No presence information'
         sip='MichiyoS@Contoso.com' id='imn_2,type=smtp'/></a>
  </span>
</nobr>

Éléments enfants

Aucun

Éléments parents

Rows

Occurrences

Minimum : 0
Maximum : valeur de l’attribut RowLimit de l’élément dsQueryResponse parent

Exemple

Vous trouverez un exemple dans Examples of Input and Result Node Trees in XSLT Transformations.

Partager via