<declaredTypes>

Contém os tipos conhecidos que o DataContractSerializer usa ao desserializar.Contains the known types that the DataContractSerializer uses when deserializing.

Para obter mais informações sobre contratos de dados e tipos conhecidos, consulte tipos conhecidos de contrato de dados.For more information about data contracts and known types, see Data Contract Known Types.

<configuration>
  <system.runtime.serialization>
    <dataContractSerializer>
      <declaredTypes>

SyntaxSyntax

<configuration>
  <system.runtime.serialization>
    <dataContractSerializer>
      <declaredTypes>
        <add type="String ">
          <knownType type="String">
            <parameter index="Integer"/>
          </knownType>
        </add>
      </declaredTypes>
    <dataContractSerializer>
  </system.runtime.serialization>
</configuration>

Atributos e elementosAttributes and Elements

As seções a seguir descrevem atributos, elementos filho e elementos pai.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

Nenhum.None.

Elementos filhoChild Elements

ElementoElement DescriçãoDescription
<add> Adiciona tipos que exigem tipos conhecidos.Adds types that require known types.

Elementos paiParent Elements

ElementoElement DescriçãoDescription
<dataContractSerializer> Contém dados de configuração para o DataContractSerializer .Contains configuration data for the DataContractSerializer.

ComentáriosRemarks

Para obter mais informações sobre tipos conhecidos, consulte tipos conhecidos de contrato de dados e DataContractSerializer .For more information about known types, see Data Contract Known Types and DataContractSerializer.

ExemploExample

O código XML a seguir mostra tipos declarados e tipos conhecidos adicionados a um DataContractSerializer elemento.The following XML code shows declared types and known types added to a DataContractSerializer element. O exemplo mostra três tipos que estão sendo adicionados.The example shows three types being added. O primeiro é um tipo personalizado chamado "Orders" que usa um tipo conhecido chamado "item".The first is a custom type named "Orders" that uses a known type named "Item". O segundo tipo declarado é um List<T> que usa Item como um tipo conhecido.The second declared type is a List<T> that uses Item as a known type. Por fim, o terceiro tipo declarado é um Dictionary<TKey,TValue> .Finally the third declared type is a Dictionary<TKey,TValue>. O Dictionary<TKey,TValue> tipo de classe é um tipo genérico, com dois parâmetros de tipo.The Dictionary<TKey,TValue> class type is a generic type, with two type parameters. O primeiro representa a chave e a segunda representa o valor.The first represents the key and the second represents the value. O exemplo a seguir adiciona um List<T> do segundo tipo (o valor) à lista de tipos conhecidos.The following example adds a List<T> of the second type (the value) to the list of known types. Você deve usar o index atributo para especificar o parâmetro de tipo a ser usado no tipo conhecido.You must use the index attribute to specify which type parameter to use in the known type. Nesse caso, o tipo de valor é indicado pelo atributo de índice definido como "1" (a coleção é baseada em zero).In this case, the value type is indicated by the index attribute set to "1" (the collection is zero-based).

<configuration>
  <system.runtime.serialization>
    <dataContractSerializer>
      <declaredTypes>
        <add type="Examples.Types.Orders, SerializationTypes, Version = 2.0.0.0, Culture = neutral, PublicKeyToken=null">
          <knownType type="Examples.Types.Item, SerializationTypes, Version=2.0.0.0, Culture=neutral, PublicKey=null" />
        </add>
        <add type="System.Collections.Generic.List`1, SerializationTypes, Version = 2.0.0.0, Culture = neutral, PublicKeyToken=null">
          <knownType type="Examples.Types.Item, SerializationTypes, Version=2.0.0.0, Culture=neutral, PublicKey=null" />
        </add>
        <add type="System.Collections.Generic.Dictionary`2, SerializationTypes, Version = 2.0.0.0, Culture = neutral, PublicKeyToken=null">
          <knownType type="System.Collections.Generic.List`1, SerializationTypes, Version = 2.0.0.0, Culture = neutral, PublicKeyToken=null">
            <parameter index="1"/>
          </knownType>
        </add>
      </declaredTypes>
    <dataContractSerializer>
  </system.runtime.serialization>
</configuration>

Consulte tambémSee also