MessageBodyMemberAttribute.Order Propriété

Définition

Espace de noms:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Obtient ou définit une valeur qui indique la position à laquelle le membre est sérialisé dans le corps 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

Valeur de propriété

Int32

Emplacement de l'élément dans le corps SOAP.

Exceptions

ArgumentOutOfRangeException

La valeur transmise à l'accesseur Set de propriété est un entier négatif.

Exemples

L'exemple de code suivant utilise la propriété Order pour sérialiser la valeur sourceAccount en premier lieu, puis la valeur targetAccount et enfin la valeur amount. Si la propriété Order n'est pas utilisée, la valeur amount est sérialisée en premier lieu.

[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;  
}  

Remarques

Utilisez la propriété Order pour spécifier l'emplacement d'un membre de données dans l'élément du corps SOAP. Il n'est pas nécessaire que la valeur soit consécutive, car elle ne représente pas la position du membre, mais uniquement la clé de tri.

Par défaut, l'ordre des éléments du corps est alphabétique. La sémantique de cette propriété est le même que celle de la propriété Order.