Compartilhar via

Referências de objeto interoperável

Por padrão, DataContractSerializer serializa objetos por valor. Você pode usar a IsReference propriedade para instruir o serializador de contrato de dados a preservar referências de objeto ao serializar objetos.

XML gerado

Como exemplo, considere o seguinte objeto:

[DataContract]  
public class X  
{  
    SomeClass someInstance = new SomeClass();  
    [DataMember]  
    public SomeClass A = someInstance;  
    [DataMember]  
    public SomeClass B = someInstance;  
}  
  
public class SomeClass
{  
}

Com PreserveObjectReferences definido como false (o padrão), o XML a seguir é gerado:

<X>  
   <A>contents of someInstance</A>  
   <B>contents of someInstance</B>  
</X>

Com PreserveObjectReferences definido como true, o XML a seguir é gerado:

<X>  
   <A id="1">contents of someInstance</A>  
   <B ref="1"></B>  
</X>

No entanto, XsdDataContractExporter não descreve os atributos id e ref em seu esquema, mesmo quando a propriedade preserveObjectReferences é definida como true.

Como usar IsReference

Para gerar informações de referência de objeto válidas de acordo com o esquema que a descreve, aplique o DataContractAttribute atributo a um tipo e defina o IsReference sinalizador como true. O exemplo a seguir modifica a classe X no exemplo anterior adicionando IsReference:

[DataContract(IsReference=true)]
public class X
{  
     SomeClass someInstance = new SomeClass();
     [DataMember]
     public SomeClass A = someInstance;
     [DataMember]
     public SomeClass B = someInstance;
}
  
public class SomeClass
{
}

O XML gerado é o seguinte:

<X>  
    <A id="1">
        <Value>contents of A</Value>  
    </A>
    <B ref="1"></B>  
</X>

O uso de IsReference garante a conformidade com a ida e volta das mensagens. Sem ele, quando um tipo é gerado a partir do esquema, a saída XML para esse tipo não é necessariamente compatível com o esquema originalmente assumido. Em outras palavras, embora os atributos id e ref tenham sido serializados, o esquema original poderia ter impedido esses atributos (ou todos os atributos) de ocorrerem no XML. Com IsReference aplicado a um membro de dados, o membro continua sendo reconhecido como passível de referência durante a ida e volta.

Consulte também

  • Last updated on