<add> des <declaredTypes>-Elements

Artikel
06/08/2023

Fügt einen während der Deserialisierung vom DataContractSerializer verwendeten Typ hinzu. Jeder deklarierte Typ umfasst die bekannten Typen, die als Feld oder Eigenschaft des deklarierten Typs zurückgegeben werden.

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

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

attribute	BESCHREIBUNG
type	Erforderliches Zeichenfolgenattribut. Gibt den Typnamen (einschließlich Namespace), den Assemblynamen, die Versionsnummer, die Kultur und das öffentliche Schlüsseltoken an.

Untergeordnete Elemente

Element	BESCHREIBUNG
<knownType>	Gibt den bekannten Typ für den deklarierten Typ an, der hinzugefügt wird. Falls es sich bei dem deklarierten Typ um einen generischen Typ handelt, müssen Sie auch dem `<knownType>`-Element ein Parameterelement hinzufügen, um anzugeben, welcher generische Parameter zum Zurückgeben des bekannten Typs verwendet wird.

Übergeordnete Elemente

Element	BESCHREIBUNG
<declaredTypes>	Enthält die Typen, die während der Deserialisierung vom DataContractSerializer bekannte Typen erfordern.

Bemerkungen

Weitere Informationen zu bekannten Typen finden Sie unter Bekannte Typen für Datenverträge und DataContractSerializer.

Ein Beispiel für die Verwendung dieses Elements finden Sie unter <dataContractSerializer>.

Hinweis

Wenn Sie den Object-Typ als <declaredType> hinzufügen, wird eine ConfigurationErrorsException ausgelöst. Der Grund hierfür ist, dass der Object-Typ in der Konfiguration nicht als deklarierter Typ verwendet werden kann.

Beispiel

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

Freigeben über