Freigeben über

XmlMembersMapping-Klasse

  • Artikel

Diese Klasse unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code bestimmt.

Stellt Zuordnungen zwischen .NET Framework-Webdienstmethoden und WSDL-Meldungen (Web Services Description Language) her, die für SOAP-Webdienste definiert werden.

Namespace: System.Xml.Serialization
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Class XmlMembersMapping
    Inherits XmlMapping
'Usage
Dim instance As XmlMembersMapping

public class XmlMembersMapping : XmlMapping

public ref class XmlMembersMapping : public XmlMapping

public class XmlMembersMapping extends XmlMapping

public class XmlMembersMapping extends XmlMapping

Hinweise

Die XmlMembersMapping-Klasse kann nicht direkt verwendet werden. Sie wird stattdessen folgendermaßen verwendet:

  • Vom Tool Wsdl.exe oder der ServiceDescriptionImporter-Klasse beim Generieren von Clientproxyklassen oder abstrakten Serverklassen aus einem WSDL-Dokument. Das WSDL-Dokument gibt die Verwendung des SOAP-Protokolls an.

  • Zum Initialisieren von XmlSerializer-Objekten, während .NET Framework einen SOAP-Webdienst oder einen Client initialisiert.

  • Von der ServiceDescriptionReflector-Klasse beim Erstellen von ServiceDescription-Objekten aus Klassen, die als SOAP-Webdienste angegeben sind.

Die XmlMembersMapping-Klasse ist ein Ersatz für die XmlTypeMapping-Klasse zum Erstellen von Zuordnungen zwischen Webdienstmethoden und Meldungen. Sie enthält eine der folgenden Entitäten, die zu einer SOAP-Webdienstmethode gehören:

  • Eingabeparameter.

  • Ausgabeparameter und Rückgabewerte.

  • SOAP-Anforderungsheader.

  • SOAP-Antwortheader.

Die Klasse stellt insbesondere Zuordnungen für eine WSDL-Meldungsdefinition dar, die den folgenden Optionen entspricht:

  • Für eine Webdienstmethode, die SOAP-Codierung verwendet: Die ElementName-Eigenschaft und die TypeName-Eigenschaft der obersten Ebene beziehen sich auf ein übergeordnetes Wrapperelement; die Meldungsteile werden durch Arraymember dargestellt. In dem selten auftretenden Fall, dass der Webdienstvorgang Dokumentstile in Verbindung mit einer gewrappten Bindung an eine .NET Framework-Methode sowie die SOAP-Codierung verwendet, beziehen sich die ElementName-Eigenschaft und die TypeName-Eigenschaft der obersten Ebene auf das einzelne part-Element, das in einem generierten WSDL-Dokument angezeigt wird.

  • Für eine Webdienstmethode, die XML-Schemadefinitionen literal verwendet: Wenn eine Webdienstmeldungen oder ein Webdienstvorgang eine gewrappte Bindung an eine .NET Framework-Methode verwendet oder nur einen einzelnen Meldungsteil definiert, beziehen sich die ElementName-Eigenschaft und die TypeName-Eigenschaft der obersten Ebene auf den Teil. Wenn mehrere Teile vorliegen (ein untypischer Fall), betreffen die ElementName-Eigenschaft und die TypeName-Eigenschaft der obersten Ebene ein übergeordnetes Wrapperelement; die Teile werden vom Count und den indizierten Arrayzugriffseigenschaften dargestellt. Außerdem wird das any-XSD-Element besonders behandelt.

Vererbungshierarchie

System.Object
   System.Xml.Serialization.XmlMapping
    System.Xml.Serialization.XmlMembersMapping

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

XmlMembersMapping-Member
System.Xml.Serialization-Namespace
XmlMemberMapping-Klasse
XmlReflectionMember
XmlTypeMapping