<add><declaredTypes>要素の<add> of <declaredTypes> Element

逆シリアル化中に、DataContractSerializer で使用される型を追加します。Adds a type used by the DataContractSerializer during deserialization. 各宣言型は、宣言型のフィールドまたはプロパティとして返される既知の型を含みます。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>

構文Syntax

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

属性および要素Attributes and Elements

以降のセクションでは、属性、子要素、および親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute [説明]Description
typetype 必須の文字列属性です。Required string attribute.

型名 (名前空間を含む)、アセンブリ名、バージョン番号、カルチャ、および公開キー トークンを指定します。Specifies the type name (including namespace), assembly name, version number, culture, and public key token.

子要素Child Elements

要素Element 説明Description
<knownType> 追加される宣言型の既知の型を指定します。Specifies the known type for the declared type that is being added. 宣言型がジェネリック型の場合は、既知の型を返すために使用されるジェネリック パラメーターを指定するために、<knownType> にパラメーター要素も追加する必要があります。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.

親要素Parent Elements

要素Element 説明Description
<declaredTypes> DataContractSerializer による逆シリアル化中に既知のタイプを必要とするタイプが含まれています。Contains the types that require known types during deserialization by the DataContractSerializer.

解説Remarks

既知の型の詳細については、「 データコントラクトの既知の型 」と「」を参照してください DataContractSerializerFor more information about known types, see Data Contract Known Types and DataContractSerializer.

<dataContractSerializer>この要素の使用例については、「」を参照してください。See the <dataContractSerializer> for an example of using this element.

注意

Object 型を <declaredType> として追加すると、ConfigurationErrorsException がスローされます。If you add the Object type as a <declaredType>, a ConfigurationErrorsException is thrown. これは、構成で Object 型を宣言型として使用できないためです。This is because the Object type cannot be used as a declared type in configuration.

Example

<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>

関連項目See also