Datenmember-ReihenfolgeData Member Order

Bei einigen Anwendungen ist es hilfreich, die Reihenfolge zu kennen, in der die Daten aus verschiedenen Datenmembern gesendet oder erwartet werden (wie z. B. die Reihenfolge, in der die Daten im serialisierten XML angezeigt werden).In some applications, it is useful to know the order in which data from the various data members is sent or is expected to be received (such as the order in which data appears in the serialized XML). Manchmal kann es auch notwendig sein, diese Reihenfolge zu ändern.Sometimes it may be necessary to change this order. In diesem Thema werden die Sortierungsregeln beschrieben.This topic explains the ordering rules.

GrundregelnBasic Rules

Zu den grundlegenden Regeln für die Sortierung von Daten gehören u. a.:The basic rules for data ordering include:

  • Wenn ein Datenvertragstyp Teil einer Vererbungshierarchie ist, stehen die Datenmember der Basistypen immer am Anfang der Reihenfolge.If a data contract type is a part of an inheritance hierarchy, data members of its base types are always first in the order.

  • Danach folgen die Datenmember des aktuellen Typs, für die die Order-Eigenschaft des Attributs DataMemberAttribute nicht festgelegt ist, in alphabetischer Reihenfolge.Next in order are the current type’s data members that do not have the Order property of the DataMemberAttribute attribute set, in alphabetical order.

  • Dann folgen die Datenmember mit der Order-Eigenschaft der DataMemberAttributeAttributgruppe.Next are any data members that have the Order property of the DataMemberAttribute attribute set. Diese sind zunächst nach dem Wert der Order-Eigenschaft geordnet und dann alphabetisch, falls mehr als ein Member eines bestimmten Order-Werts vorhanden ist.These are ordered by the value of the Order property first and then alphabetically if there is more than one member of a certain Order value. Die Reihenfolgenwerte können übersprungen werden.Order values may be skipped.

Die alphabetische Reihenfolge wird erstellt, indem die CompareOrdinal-Methode aufgerufen wird.Alphabetical order is established by calling the CompareOrdinal method.

BeispieleExamples

Betrachten Sie folgenden Code.Consider the following code.

[DataContract]
public class BaseType
{

    [DataMember]
    public string zebra;
}
[DataContract]
public class DerivedType : BaseType
{
    [DataMember(Order = 0)]
    public string bird;
    [DataMember(Order = 1)]
    public string parrot;
    [DataMember]
    public string dog;
    [DataMember(Order = 3)]
    public string antelope;
    [DataMember]
    public string cat;
    [DataMember(Order = 1)]
    public string albatross;
}
<DataContract()> _
Public Class BaseType
    <DataMember()> Public zebra As String
End Class

<DataContract()> _
Public Class DerivedType
    Inherits BaseType
    <DataMember(Order:=0)> Public bird As String
    <DataMember(Order:=1)> Public parrot As String
    <DataMember()> Public dog As String
    <DataMember(Order:=3)> Public antelope As String
    <DataMember()> Public cat As String
    <DataMember(Order:=1)> Public albatross As String
End Class

Das generierte XML sieht ähnlich aus wie das folgende.The XML produced is similar to the following.

<DerivedType>  
    <!-- Zebra is a base data member, and appears first. -->  
    <zebra/>   

    <!-- Cat has no Order, appears alphabetically first. -->  
    <cat/>  

   <!-- Dog has no Order, appears alphabetically last. -->  
    <dog/>   

    <!-- Bird is the member with the smallest Order value -->  
    <bird/>  

    <!-- Albatross has the next Order value, alphabetically first. -->  
    <albatross/>  

    <!-- Parrot, with the next Order value, alphabetically last. -->  
     <parrot/>  

    <!-- Antelope is the member with the highest Order value. Note that   
    Order=2 is skipped -->  
     <antelope/>   
</DerivedType>  

Siehe auchSee Also

DataContractAttribute
DatenvertragsäquivalenzData Contract Equivalence
Verwenden von DatenverträgenUsing Data Contracts