Interfejs System.Runtime.Serialization.IExtensibleDataObject

Ten artykuł zawiera dodatkowe uwagi dotyczące dokumentacji referencyjnej dla tego interfejsu API.

Interfejs IExtensibleDataObject udostępnia jedną właściwość, która ustawia lub zwraca strukturę używaną do przechowywania danych zewnętrznych dla kontraktu danych. Dodatkowe dane są przechowywane w klasie ExtensionDataObject i dostępne przez właściwość ExtensionData. W operacji dwukierunkowej, w której dane są odbierane, przetwarzane i wysyłane z powrotem, dodatkowe dane są wysyłane z powrotem do oryginalnego nadawcy bez zmian. Jest to przydatne do przechowywania danych otrzymanych z przyszłych wersji kontraktu. Jeśli interfejs nie zostanie zaimplementowany, wszelkie dodatkowe dane zostaną zignorowane i odrzucone podczas operacji dwukierunkowej.

Aby użyć tej funkcji wersjonowania

1. Zaimplementuj IExtensibleDataObject interfejs w klasie .

2. Dodaj właściwość ExtensionData do swojego typu.

3. Dodaj prywatny element członkowski typu ExtensionDataObject do klasy.

4. Zaimplementuj metody pobierania i ustawiania właściwości przy użyciu nowego pola prywatnego.

5. DataContractAttribute Zastosuj atrybut do klasy . Ustaw właściwości Name i Namespace na odpowiednie wartości, jeśli to konieczne.

Aby uzyskać więcej informacji na temat przechowywania wersji typów, zobacz Przechowywanie wersji kontraktu danych. Aby uzyskać informacje na temat tworzenia kontraktów danych zgodnych z przyszłymi wersjami, zobacz Forward-Compatible Data Contracts. Aby uzyskać więcej informacji na temat kontraktów danych, zobacz Using Data Contracts (Używanie kontraktów danych).