MessageBodyMemberAttribute.Order Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der die Position angibt, an der das Element in den SOAP-Textkörper serialisiert wird.
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
Die Position des Elements im SOAP-Textkörper.
Ausnahmen
Der an den Eigenschaftensatz übergebene Wert ist eine negative ganze Zahl.
Beispiele
Im folgenden Codebeispiel wird die Order Eigenschaft verwendet, um den sourceAccount Wert zuerst zu serialisieren, den targetAccount Zweiten und den amount dritten Wert. 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 den Speicherort eines Datenelements im SOAP-Textelement anzugeben. Der Wert muss nicht aufeinander folgen, da er nicht die Position des Elements darstellt, nur der Sortierschlüssel.
Die Reihenfolge der Textkörperelemente ist standardmäßig alphabetisch. Die Semantik dieser Eigenschaft ist identisch mit der Semantik der Order Eigenschaft.