Section Données

S’applique à : Access 2013, Office 2013

La section des données définit les données du groupe de lignes ainsi que toutes les mises à jour, insertions ou suppressions en attente. Elle peut contenir zéro ou plusieurs lignes. Elle peut uniquement contenir des données d'un seul groupe de lignes, la ligne étant définie par le schéma. En outre, comme mentionné précédemment, les colonnes dépourvues de données peuvent être ignorées. Si un attribut ou un sous-élément est utilisé dans la section des données et que cette construction a été définie dans la section du schéma, il est ignoré de façon silencieuse.

String

Les caractères XML réservés dans les données texte doivent être remplacés par des entités de caractères appropriées. Par exemple, dans le nom de société « Joe's Garage », le guillemet simple doit être remplacé par une entité. La ligne doit donc ressembler à ce qui suit :

<z:row CompanyName="Joe&apos;s Garage"/> 

Les caractères suivants sont réservés au format XML et doivent être remplacés par des entités de caractères : {', »,&,<}>.

Binaire

Les données binaires sont codées en type de données bin.hex (c'est-à-dire qu'un octet correspond à deux caractères, un caractère par quartet).

DateTime

Le format VT_DATE de type Variant n'est pas directement pris en charge par les types de données XML-Data. Le format correct des dates avec un composant de date et d'heure est : aaaa-mm-jjThh:mm:ss.

Pour plus d’informations sur les formats de date spécifiés par XML, consultez W3C XMLData Note.

Lorsque la spécification XML-Data définit deux types de données équivalents (par exemple, i4 == int), ADO écrit le nom convivial mais lit les deux formats.

Gestion des modifications en attente

Vous pouvez ouvrir un objet Recordset en mode de mise à jour immédiate ou par lot. Dans le cas d'une ouverture en mode de mise à jour par lot avec des curseurs côté client, toutes les modifications apportées à l'objet Recordset sont en attente tant que la méthode UpdateBatch n'a pas été appelée. Les modifications en attente sont aussi conservées lorsque l'objet Recordset est enregistré. Dans XML, elles sont représentées par l'utilisation d'éléments de mise à jour définis dans urn:schemas-microsoft-com:rowset. En outre, si un groupe de lignes peut être mis à jour, la propriété modifiable doit être affectée de la valeur True dans la définition de la ligne. Par exemple, pour indiquer que la table Shippers contient des modifications en attente, la définition de la ligne doit ressembler à ce qui suit :

<s:ElementType name="row" content="eltOnly" updatable="true"> 
  <s:attribute type="ShipperID"/> 
  <s:attribute type="CompanyName"/> 
  <s:attribute type="Phone"/> 
  <s:extends type="rs:rowbase"/> 
</s:ElementType> 

Ceci indique au fournisseur de persistance d'exposer les données afin qu'ADO puisse créer un objet Recordset modifiable.

L'exemple de données suivant montre à quoi ressemblent les insertions, modifications et suppressions dans le fichier persisté :

<rs:data> 
  <z:row ShipperID="2" CompanyName="United Package"  
    Phone="(503) 555-3199"/> 
<rs:update> 
  <rs:original> 
    <z:row ShipperID="3" CompanyName="Federal Shipping"  
      Phone="(503) 555-9931"/> 
  </rs:original> 
  <z:row Phone="(503) 552-7134"/> 
</rs:update> 
<rs:insert> 
  <z:row ShipperID="12" CompanyName="Lightning Shipping"  
    Phone="(505) 111-2222"/> 
  <z:row ShipperID="13" CompanyName="Thunder Overnight"  
    Phone="(505) 111-2222"/> 
  <z:row ShipperID="14" CompanyName="Blue Angel Air Delivery"  
    Phone="(505) 111-2222"/> 
</rs:insert> 
<rs:delete> 
  <z:row ShipperID="1" CompanyName="Speedy Express" Phone="(503) 555-9831"/> 
</rs:delete> 
</rs:data> 

Une mise à jour contient toujours les données de la ligne source complète suivies des données de la ligne modifiée. La ligne modifiée peut contenir toutes les colonnes ou seulement celles qui ont été modifiées. Dans l'exemple précédent, la ligne relative à Shipper 2 n'a pas été modifiée tandis que seule la colonne Phone l'a été pour Shipper 3 et est donc la seule colonne comprise dans la ligne modifiée. Les lignes insérées pour Shipper 12, 13 et 14 sont regroupées sous une seule balise rs:insert. Notez que les lignes supprimées peuvent être aussi regroupées, bien que l'exemple ne le montre pas.