MessageBodyMemberAttribute.Order Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее позицию, в которой член сериализуется в текст SOAP-сообщения.
public:
property int Order { int get(); void set(int value); };
public int Order { get; set; }
member this.Order : int with get, set
Public Property Order As Integer
Значение свойства
Расположение элемента в тексте SOAP-сообщения.
Исключения
Значение, переданное методу задания свойства, является отрицательным целым числом.
Примеры
В следующем примере кода используется свойство Order для сериализации значения sourceAccount
первым, значения targetAccount
вторым и значения amount
третьим. Если свойство Order не используется, первым сериализуется значение amount
.
[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;
}
Комментарии
Используйте свойство Order для задания расположения члена данных в элементе текста SOAP-сообщения. Не требуется, чтобы значение было последовательным, так как оно представляет не позицию члена, а только ключ сортировки.
По умолчанию порядок элементов текста сообщения — алфавитный. Семантика этого свойства аналогична семантике свойства Order.