Interface System.Runtime.Serialization.IExtensibleDataObject

Opmerking

In dit artikel vindt u aanvullende opmerkingen in de referentiedocumentatie voor deze API.

De IExtensibleDataObject interface biedt één eigenschap waarmee een structuur wordt ingesteld of geretourneerd die wordt gebruikt voor het opslaan van gegevens die extern zijn voor een gegevenscontract. De extra gegevens worden opgeslagen in een exemplaar van de ExtensionDataObject klasse en geopend via de ExtensionData eigenschap. In een ronde-operatie waarin gegevens worden ontvangen, verwerkt en teruggezonden, worden de extra gegevens intact naar de oorspronkelijke afzender verzonden. Dit is handig voor het opslaan van gegevens die zijn ontvangen van toekomstige versies van het contract. Als u de interface niet implementeert, worden eventuele extra gegevens genegeerd en verwijderd tijdens een retourbewerking.

Om deze versiefunctie te gebruiken

  1. Implementeer de IExtensibleDataObject interface in een klasse.

  2. Voeg de ExtensionData eigenschap toe aan uw type.

  3. Voeg een privélid van het type ExtensionDataObject toe aan de klasse.

  4. Implementeer get- en set-methoden voor de eigenschap met behulp van het nieuwe private-lid.

  5. Pas het DataContractAttribute kenmerk toe op de klasse. Stel indien nodig de Name en Namespace eigenschappen in op de juiste waarden.

Zie Versiebeheer van gegevenscontract voor meer informatie over versiebeheer van typen. Zie Forward-Compatible Data Contracts voor informatie over het maken van forward-compatibele gegevenscontracten. Zie Gegevenscontracten gebruiken voor meer informatie over gegevenscontracten.