データコントラクトの使用

[アーティクル]
02/24/2011

データコントラクトは、サービスとクライアントの間の正式な取り決めであり、交換されるデータが抽象的に記述されています。つまり、クライアントとサービスが通信するために必要なのは同じデータコントラクトだけで、同じ型を共有する必要はありません。データコントラクトは、パラメーターまたは戻り値の型ごとに、交換するためにシリアル化する (XML に変換する) 必要があるデータを正確に定義します。

データコントラクトの基本

Windows Communication Foundation (WCF) は、データコントラクトシリアライザーと呼ばれるシリアル化エンジンを既定で使用して、データのシリアル化と逆シリアル化 (データと XML の間の変換) を行います。すべての .NET Framework プリミティブ型 (整数や文字列など) およびプリミティブ型として扱われる特定の型 (DateTime や XmlElement など) は、準備なしでシリアル化できるため、既定のデータコントラクトを持つと見なされます。多くの .NET Framework 型もまた、既存のデータコントラクトを持ちます。シリアル化できるすべての型の一覧については、「データコントラクトシリアライザーでサポートされる型」を参照してください。

新しい複合型を作成したら、シリアル化できるように、データコントラクトを定義する必要があります。既定では、DataContractSerializer はデータコントラクトを推測し、公開されている型をすべてシリアル化します。その型の読み書き可能なパブリックプロパティおよびパブリックフィールドは、すべてシリアル化されます。IgnoreDataMemberAttribute を使用することにより、メンバーがシリアル化されないようにすることができます。また、DataContractAttribute 属性および DataMemberAttribute 属性を使用して、データコントラクトを明示的に作成することもできます。これを行うには、通常、その型に DataContractAttribute 属性を適用します。この属性は、クラス、構造体、および列挙体に適用できます。次に、データコントラクト型の各メンバーに DataMemberAttribute 属性を適用して、それがデータメンバーであること、つまり、シリアル化する必要があることを示す必要があります。詳細については、次のトピックを参照してください。、「シリアル化可能な型」を参照してください。

例

ServiceContractAttribute 属性と OperationContractAttribute 属性が明示的に適用されたサービスコントラクト (インターフェイス) の例を次に示します。この例は、プリミティブ型はデータコントラクトを必要としないのに対し、複合型は必要とすることを示しています。

<ServiceContract()>  _
Public Interface ISampleInterface
    ' No data contract is requred since both the parameter and return 
    ' types are both primitive types.
    <OperationContract()>  _
    Function SquareRoot(ByVal root As Integer) As Double 
    
    ' No Data Contract required because both parameter and return 
    ' types are marked with the SerializableAttribute attribute.
    <OperationContract()>  _
    Function GetPicture(ByVal pictureUri As System.Uri) As System.Drawing.Bitmap 
    
    ' The MyTypes.PurchaseOrder is a complex type, and thus 
    ' requires a data contract.
    <OperationContract()>  _
    Function ApprovePurchaseOrder(ByVal po As MyTypes.PurchaseOrder) As Boolean 
End Interface

[ServiceContract]
public interface ISampleInterface
{
    // No data contract is requred since both the parameter 
    // and return types are primitive types.
    [OperationContract]
    double SquareRoot(int root);

    // No Data Contract required because both parameter and return 
    // types are marked with the SerializableAttribute attribute.
    [OperationContract]
    System.Drawing.Bitmap GetPicture(System.Uri pictureUri);

    // The MyTypes.PurchaseOrder is a complex type, and thus 
    // requires a data contract.
    [OperationContract]
    bool ApprovePurchaseOrder(MyTypes.PurchaseOrder po);
}

次の例では、MyTypes.PurchaseOrder 型のデータコントラクトが作成され、DataContractAttribute と DataMemberAttribute 属性がクラスとそのメンバーに適用されるかを示します。

Namespace MyTypes
    <System.Runtime.Serialization.DataContractAttribute()>  _
    Public Class PurchaseOrder
        Private poId_value As Integer
        
        ' Apply the DataMemberAttribute to the property.
        
        <DataMember()>  _
        Public Property PurchaseOrderId() As Integer 
            
            Get
                Return poId_value
            End Get
            Set
                poId_value = value
            End Set
        End Property
    End Class 
End Namespace

namespace MyTypes
{
    [DataContract]
    public class PurchaseOrder
    {
        private int poId_value;

        // Apply the DataMemberAttribute to the property.
        [DataMember]
        public int PurchaseOrderId
        {

            get { return poId_value; }
            set { poId_value = value; }
        }
    }
}

メモ

以下に、データコントラクトを作成する際に考慮する必要がある項目を示します。

IgnoreDataMemberAttribute 属性は、マークされていない型で使用した場合にのみ受け入れられます。これには、DataContractAttribute、SerializableAttribute、CollectionDataContractAttribute、EnumMemberAttribute のいずれかの属性でマークされていない型、または他の方法 (IXmlSerializable など) でシリアル化可能としてマークされた型が含まれます。
DataMemberAttribute 属性は、フィールドおよびプロパティに適用できます。
メンバーのアクセシビリティレベル (内部、プライベート、保護、またはパブリック) は、データコントラクトに影響しません。
DataMemberAttribute 属性が静的メンバーに適用されている場合は無視されます。
シリアル化中には、プロパティのデータメンバーがシリアル化対象のプロパティの値を取得できるように、プロパティ取得コードが呼び出されます。
逆シリアル化中には、まず初期化されていないオブジェクトが、その型のコンストラクターを呼び出さずに作成されます。次に、すべてのデータメンバーが逆シリアル化されます。
逆シリアル化中には、プロパティのデータメンバーが、プロパティを逆シリアル化されている値に設定できるように、プロパティ設定コードが呼び出されます。
データコントラクトが有効であるためには、すべてのデータメンバーをシリアル化できる必要があります。シリアル化できるすべての型の一覧については、「データコントラクトシリアライザーでサポートされる型」を参照してください。

ジェネリック型は、非ジェネリック型とまったく同じように処理されます。ジェネリックパラメーターに対する特別な要件はありません。たとえば、次の型について考えます。

<DataContract()>  _
Public Class MyGenericType1 (Of T)
    ' Code not shown.
End Class

[DataContract]
public class MyGenericType1<T>
{
    // Code not shown.
}

この型は、ジェネリック型パラメーター (T) に使用される型をシリアル化できるかどうかに関係なくシリアル化できます。すべてのデータメンバーをシリアル化できる必要があるため、次の型をシリアル化できるのは、ジェネリック型パラメーターもシリアル化できる場合だけです。次のコード例を参照してください。

<DataContract()> Public Class MyGenericType2(Of T)

    <DataMember()> Dim theData As T

End Class

[DataContract]
public class MyGenericType2<T>
{
    [DataMember]
    T theData;
}

参照

次の方法で共有

データコントラクトの使用

データコントラクトの基本

例

メモ

参照

処理手順

リファレンス

概念

その他のリソース

次の方法で共有

データ コントラクトの使用

データ コントラクトの基本

例

メモ

参照

処理手順

リファレンス

概念

その他のリソース

データコントラクトの使用

データコントラクトの基本