Disponibilité

Flash Player 7.

Edition

Flash MX Professional 2004.

Utilisation

dataSetInstance.deltaPacket

Description

Propriété qui renvoie un objet DeltaPacket contenant toutes les opérations de modification réalisées sur la collection dataSet et ses éléments. Cette propriété est null tant que DataSet.applyUpdates() est appelée sur dataSet.

Lorsque DataSet.applyUpdates() est appelée, un ID de transaction est affecté à l'objet DeltaPacket. Cet ID de transaction permet d'identifier l'objet DeltaPacket sur une boucle de mise à jour à partir du serveur vers le client. Toute affectation ultérieure à la propriété deltaPacket via un objet DeltaPacket possédant un ID de transaction correspondant est considérée comme étant la réponse du serveur aux modifications envoyées précédemment.
Un objet DeltaPacket possédant un ID correspondant est utilisé pour mettre à jour la collection et rapporter les erreurs spécifiées au sein du paquet.

Les erreurs et les messages du serveur sont rapportés aux écouteurs de l'événement DataSet.resolveDelta. Notez que les paramètres DataSet.logChanges sont ignorés si un objet DeltaPacket possédant un ID correspondant est affecté à DataSet.deltaPacket.
Un paquet delta sans ID de transaction correspondant met la collection à jour, comme si les API DataSet étaient utilisées directement. Le cas échéant, des entrées delta supplémentaires peuvent être créées selon ce que le paramètre DataSet.logChanges actif de dataSet et le paquet delta indiquent.

Une exception DataSetError est émise lorsqu'un paquet delta est affecté avec un ID de transaction correspondant et que l'un des éléments du paquet delta nouvellement affecté est introuvable dans le paquet d'origine.

Voir aussi

DataSet.applyUpdates(), DataSet.logChanges, DataSet.resolveDelta