Order Property
Collapse the table of content
Expand the table of content

MessageBodyMemberAttribute.Order Property

 

Gets or sets a value that indicates the position in which the member is serialized into the SOAP body.

Namespace:   System.ServiceModel
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public int Order { get; set; }

Property Value

Type: System.Int32

The location of the element in the SOAP body.

Exception Condition
ArgumentOutOfRangeException

The value passed to the property setter is a negative integer.

Use the Order property to specify the location of a data member in the SOAP body element. The value is not required to be consecutive, because it does not represent the position of the member, only the sorting key.

The order of the body elements is alphabetical by default. The semantics of this property are the same as the semantics of the Order property.

The following code example uses the Order property to serialize the sourceAccount value first, the targetAccount value second and the amount value third. If the Order property is not used, the amount value is serialized first.

[MessageContract]
public class BankingTransaction
{
  [MessageHeader] public Operation operation;
  [MessageBodyMember(Order=1)] public Account sourceAccount;
  [MessageBodyMember(Order=2)] public Account targetAccount;
  [MessageBodyMember(Order=3)] public int amount;
}

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 3.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show:
© 2016 Microsoft