IsRequired Property
Collapse the table of content
Expand the table of content

DataMemberAttribute.IsRequired Property

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Gets or sets a value that instructs the serialization engine whether the member must be present in the serialized data when it is being deserializing.

Namespace:  System.Runtime.Serialization
Assembly:  System.Runtime.Serialization (in System.Runtime.Serialization.dll)

'Declaration
Public Property IsRequired As Boolean

Property Value

Type: System.Boolean
true, if the member is required; otherwise, false. The default is false.

ExceptionCondition
SerializationException

The member is not present or the member is present but it has a default value with EmitDefaultValue set to true.

The property is used for ensuring compatibility with future versions of a type.


		' Define the data contract.
		<DataContract(Name := "Customer", Namespace := "http://www.contoso.com")> _
		Public Class User
			Private privateName As String
			<DataMember(Name := "Last", EmitDefaultValue := True, IsRequired := True, Order := 2)> _
			Public Property Name() As String
				Get
					Return privateName
				End Get
				Set(ByVal value As String)
					privateName = value
				End Set
			End Property

			Private privateAge As Integer
			<DataMember(Order := 1)> _
			Public Property Age() As Integer
				Get
					Return privateAge
				End Get
				Set(ByVal value As Integer)
					privateAge = value
				End Set
			End Property

			Public Sub New()
			End Sub

			Public Sub New(ByVal newName As String, ByVal newAge As Integer)
					Name = newName
					Age = newAge
			End Sub
		End Class


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2017 Microsoft