Élément Row (dsQueryResponse)

S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | 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
Attachments 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 "_." du nom du fichier. Par exemple, QuarterlySummaries_.Quarter1.docx . Cette valeur d’attribut est la concatenation des valeurs de l’attribut FileLeafRef.Name et de l’attribut FileLeafRef.Suffix avec un "." caractère séparateur.
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 caractère 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 Element (View) et SharePoint Data View Web Part Extension Functions dans l’espace de noms ddwrt.
HTML_x0020_File_x0020_Type.File_x0020_Type.mapcon Facultatif. Valeur renvoyée par un appel de la fonction MapToControl pendant la transformation XSLT. Pour plus d’informations, voir MapToControl(SPWeb, String, String), MapToControl, élément (View)et SharePoint Data View Web Part Extension Functions dans l’espace de noms ddwrt.
HTML_x0020_File_x0020_Type.File_x0020_Type.mapico Facultatif. Valeur renvoyée par un appel de la fonction MapToIcon pendant la transformation XSLT. Pour plus d’informations, voir Icon(), MapToIcon Element (View)et SharePoint Data View Web Part Extension Functions in the ddwrt Namespace.
ID Obligatoire. ID de l’élément de liste.
PermMask Masque des 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 a le même nom que le nom interne du champ.
some_field Facultatif. Les types de champ monétaire, numérique et de recherche dans SharePoint Foundation peuvent avoir une mise en forme de bas niveau avant même qu’une mise en forme HTML ne soit appliquée. Par exemple, une valeur monétaire négative est entre parenthèses. L’attribut de chaque champ de ce type est immédiatement suivi d’un autre attribut qui a le même nom, auquel un caractère "." est attribué. Cet attribut fournit la valeur du champ en tant que données brutes non formatées. Par exemple, une valeur monétaire négative est avancer par un signe moins ( ) et n’est pas entre "-" parenthèses.
some_booleanField . Valeur Facultatif. Chaque attribut booléen dans l’élément de liste est suivi d’un autre attribut qui a le même nom, auquel est ".Value" ensuite appended. Cet attribut donne la forme non localisée brute de la valeur du champ (1 ou 0), tandis que l’attribut principal du champ booléen donne la valeur relative aux paramètres régionaux du site web.
some_date_time_field .ifnew Facultatif. 1 si la valeur d’heure de date est suffisamment récente pour définir l’élément de liste comme nouveau ; dans le cas contraire, 0. Cet attribut apparaît uniquement si le 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 qui a le même nom, auquel un caractère est "." ajoutée. Cet attribut fournit la valeur brute d’un champ datetime tel qu’il est 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 aux blogs.
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 aux blogs.
some_date_time_field . ISO8601 Facultatif. Valeur d’un champ DateTime formaté conformément à la norme ISO8601. Utilisé uniquement sur les listes liées aux blogs.
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 aux blogs.
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 aux blogs.
some_user_field .id Facultatif. Si un attribut représente un champ de type Utilisateur, il existe un autre attribut qui a le même nom, auquel est ".id" appended. Il s’agit du numéro d’ID relatif au site de l’utilisateur.
some_user_field .title Facultatif. Si un attribut représente un champ de type Utilisateur, il existe un autre attribut qui a le même nom, auquel est ".title" appended. 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 code d’étendue HTML de 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 qui a le même nom, auquel est ".span" appended. Il s’agit d’une version plus simple du code 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 URL, il existe un autre attribut qui a le même nom, auquel « .desc » est ajoute. Cela fournit une description de l’URL.

Ce markup est utilisé pour restituer le champ lorsque l’indicateur FreeForm de la propriété ListViewWebPart.ViewFlags n’est pas définie ; Sinon, la valeur de l 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 markup est utilisé pour restituer le champ lorsque l’indicateur FreeForm de la propriété ListViewWebPart.ViewFlags est définie ; Sinon, la valeur de l 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

Occurrences

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

Exemple

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