MessageBodyMemberAttribute.Order Eigenschaft

Definition

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Quelle:

MessageBodyMemberAttribute.cs

Ruft einen Wert ab, der die Position angibt, in der der Member im SOAP-Text serialisiert wird, bzw. legt diesen fest.

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

Eigenschaftswert

Int32

Die Position des Elements im SOAP-Text.

Ausnahmen

ArgumentOutOfRangeException

Der an den Eigenschaftensetter übergebene Wert ist eine negative Ganzzahl.

Beispiele

Im folgenden Codebeispiel wird mithilfe der Order-Eigenschaft zuerst der sourceAccount-Wert, dann der targetAccount-Wert und als drittes der amount-Wert serialisiert. Wenn die Order-Eigenschaft nicht verwendet wird, wird der amount-Wert zuerst serialisiert.

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

Hinweise

Verwenden Sie die Order-Eigenschaft, um die Position eines Datenmembers im SOAP-Textelement anzugeben. Der Wert muss nicht ein aufeinander folgender Wert sein, da er nicht die Position des Members darstellt, sondern nur den Sortierschlüssel.

Die Reihenfolge der Textelement ist standardmäßig die alphabetische Reihenfolge. Die Semantik dieser Eigenschaft ist die gleiche wie für die Order-Eigenschaft.