Interface System.Runtime.Serialization.IExtensibleDataObject

Cet article fournit des remarques supplémentaires à la documentation de référence de cette API.

L’interface IExtensibleDataObject fournit une propriété unique qui définit ou retourne une structure utilisée pour stocker des données externes à un contrat de données. Les données supplémentaires sont stockées dans une instance de la ExtensionDataObject classe et accessibles via la ExtensionData propriété. Dans une opération aller-retour où les données sont reçues, traitées et renvoyées, les données supplémentaires sont renvoyées à l’expéditeur d’origine intacte. Cela est utile pour stocker les données reçues des futures versions du contrat. Si vous n’implémentez pas l’interface, toutes les données supplémentaires sont ignorées et ignorées pendant une opération aller-retour.

Pour utiliser cette fonctionnalité de contrôle de version

1. Implémentez l’interface IExtensibleDataObject dans une classe.

2. Ajoutez la ExtensionData propriété à votre type.

3. Ajoutez un membre privé de type ExtensionDataObject à la classe.

4. Implémentez les méthodes get et set pour la propriété à l’aide du nouveau membre privé.

5. Appliquez l’attribut DataContractAttribute à la classe. Définissez les Name valeurs appropriées et Namespace les propriétés si nécessaire.

Pour plus d’informations sur le contrôle de version des types, consultez Gestion des versions de contrat de données. Pour plus d’informations sur la création de contrats de données compatibles avec le transfert, consultez Forward-Compatible Contrats de données. Pour plus d’informations sur les contrats de données, consultez Utilisation des contrats de données.