How to: Create a Basic Data Contract for a Class or Structure

This topic shows the basic steps to create a data contract using a class or structure. For more information about data contracts and how they are used, see Using Data Contracts.

For a tutorial that walks through the steps of creating a basic Windows Communication Foundation (WCF) service and client, see the Getting Started Tutorial. For a working sample application that consists of a basic service and client, see Basic Data Contract.

To create a basic data contract for a class or structure

  1. Declare that the type has a data contract by applying the DataContractAttribute attribute to the class. Note that all public types, including those without attributes, are serializable. The DataContractSerializer infers a data contract if the DataContractAttribute attribute is absent. For more information, see , see Serializable Types.

  2. Define the members (properties, fields, or events) that are serialized by applying the DataMemberAttribute attribute to each member. These members are called data members. By default, all public types are serializable. For more information, see , see Serializable Types.

    You can apply the DataMemberAttribute attribute to private fields, causing the data to be exposed to others. Be sure that the member does not contain sensitive data.


The following example shows how to create a data contract for the Person type by applying the DataContractAttribute and DataMemberAttribute attributes to the class and its members.

<DataContract()>  _
Public Class Person
    ' This member is serialized.
    <DataMember()>  _
    Friend FullName As String
    ' This is serialized even though it is private.
    <DataMember()>  _
    Private Age As Integer
    ' This is not serialized because the DataMemberAttribute 
    ' has not been applied.
    Private MailingAddress As String
    ' This is not serialized, but the property is.
    Private telephoneNumberValue As String
    <DataMember()>  _
    Public Property TelephoneNumber() As String 
            Return telephoneNumberValue
        End Get
            telephoneNumberValue = value
        End Set
    End Property
End Class 

See Also

© 2007 Microsoft Corporation. All rights reserved.
Build Date: 2009-08-07

Community Additions