MessageBodyMemberAttribute.Order Proprietà

Definizione

Spazio dei nomi:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v8.0.0

Ottiene o imposta un valore che indica la posizione in cui il membro viene serializzato nel corpo 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

Valore della proprietà

Int32

Posizione dell'elemento nel corpo SOAP.

Eccezioni

ArgumentOutOfRangeException

Il valore passato al metodo di impostazione della proprietà è un numero intero negativo.

Esempio

Nell'esempio di codice seguente viene utilizzata la proprietà Order per serializzare prima il valore sourceAccount, poi il valore targetAccount e quindi il valore amount. Se non si utilizza la proprietà Order, viene serializzato per primo il valore 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;  
}  

Commenti

Utilizzare la proprietà Order per specificare la posizione di un membro dati nell'elemento del corpo SOAP. Non è necessario che il valore sia consecutivo, poiché non rappresenta la posizione del membro ma solo la chiave di ordinamento.

L'ordine degli elementi del corpo è alfabetico per impostazione predefinita. La semantica di questa proprietà corrisponde a quella della proprietà Order.