<add> do <declaredTypes> elemento<add> of <declaredTypes> Element

Adiciona um tipo usado pelo DataContractSerializer durante a desserialização.Adds a type used by the DataContractSerializer during deserialization. Cada tipo declarado inclui os tipos conhecidos que serão retornados como um campo ou Propriedade do tipo declarado.Each declared type includes the known types that will be returned as a field or property of the declared type.

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

SyntaxSyntax

<add type="String">
  <knownType type="String">
    <parameter index="Integer"
               type="String" />
  </knownType>
</add>

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

AtributoAttribute DescriçãoDescription
typetype Atributo de cadeia de caracteres obrigatório.Required string attribute.

Especifica o nome do tipo (incluindo o namespace), o nome do assembly, o número de versão, a cultura e o token de chave pública.Specifies the type name (including namespace), assembly name, version number, culture, and public key token.

Elementos filhoChild Elements

ElementoElement DescriçãoDescription
<knownType> Especifica o tipo conhecido para o tipo declarado que está sendo adicionado.Specifies the known type for the declared type that is being added. Se o tipo declarado for um tipo genérico, você também deverá adicionar um elemento de parâmetro ao <knownType> elemento para especificar qual parâmetro genérico é usado para retornar o tipo conhecido.If the declared type is a generic type, then you must also add a parameter element to the <knownType> element to specify which generic parameter is used to return the known type.

Elementos paiParent Elements

ElementoElement DescriçãoDescription
<declaredTypes> Contém os tipos que exigem tipos conhecidos durante a desserialização pelo DataContractSerializer .Contains the types that require known types during deserialization by 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.

Consulte o <dataContractSerializer> para obter um exemplo de como usar esse elemento.See the <dataContractSerializer> for an example of using this element.

Observação

Se você adicionar o Object tipo como um <declaredType> , um ConfigurationErrorsException será lançado.If you add the Object type as a <declaredType>, a ConfigurationErrorsException is thrown. Isso ocorre porque o Object tipo não pode ser usado como um tipo declarado na configuração.This is because the Object type cannot be used as a declared type in configuration.

ExemploExample

<add type="MyCompany.Library.Shape,
           MyAssembly, Version=2.0.0.0, Culture=neutral,
           PublicKeyToken=XXXXXX, processorArchitecture=MSIL">
  <knownType type="MyCompany.Library.Circle,
                   MyAssembly, Version=2.0.0.0, Culture=neutral,
                   PublicKeyToken=XXXXXX,
                   processorArchitecture=MSIL" />
</add>

Consulte tambémSee also