IExtensibleDataObject インターフェイス

定義

名前空間:

System.Runtime.Serialization

アセンブリ:

netstandard.dll, System.Runtime.Serialization.Xml.dll

ソース:

IExtensibleDataObject.cs

XmlObjectSerializer が DataContractAttribute 属性でマークされた型の逆シリアル化中に検出した追加データを格納するためのデータ構造体を提供します。

C#

public interface IExtensibleDataObject

派生

例

次のコードは、シリアル化可能な型 (PersonVersion2) の第 2 のバージョンである型 (Person) のインスタンスを示しています。 第 2 のバージョンは、第 1 のバージョンにない追加データ (ID フィールド) を含みます。

C#

// Implement the IExtensibleDataObject interface
// to store the extra data for future versions.
[DataContract(
    Name = "Person",
    Namespace = "http://www.cohowinery.com/employees")]
class Person : IExtensibleDataObject
{
    // To implement the IExtensibleDataObject interface,
    // you must implement the ExtensionData property. The property
    // holds data from future versions of the class for backward
    // compatibility.
    private ExtensionDataObject extensionDataObject_value;
    public ExtensionDataObject ExtensionData
    {
        get
        {
            return extensionDataObject_value;
        }
        set
        {
            extensionDataObject_value = value;
        }
    }
    [DataMember]
    public string Name;
}

// The second version of the class adds a new field. The field's
// data is stored in the ExtensionDataObject field of
// the first version (Person). You must also set the Name property
// of the DataContractAttribute to match the first version.
// If necessary, also set the Namespace property so that the
// name of the contracts is the same.
[DataContract(Name = "Person",
    Namespace = "http://www.cohowinery.com/employees")]
class PersonVersion2 : IExtensibleDataObject
{
    // Best practice: add an Order number to new members.
    [DataMember(Order=2)]
    public int ID;

    [DataMember]
    public string Name;

    private ExtensionDataObject extensionDataObject_value;
    public ExtensionDataObject ExtensionData
    {
        get
        {
            return extensionDataObject_value;
        }
        set
        {
            extensionDataObject_value = value;
        }
    }
}

注釈

この API の詳細については、「 IExtensibleDataObject の補足 API 解説」を参照してください。

プロパティ

ExtensionData

追加のデータを格納する構造体を取得または設定します。

適用対象

こちらもご覧ください

• ExtensionDataObject
• データ コントラクトのバージョン管理
• データ コントラクトの使用