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.
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
Die Position des Elements im SOAP-Text.
Ausnahmen
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.