SoapIncludeAttribute Klas

Definitie

public ref class SoapIncludeAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
    inherit Attribute

Public Class SoapIncludeAttribute
Inherits Attribute

Overname

Object

Attribute

SoapIncludeAttribute

Kenmerken

AttributeUsageAttribute

Voorbeelden

In het volgende voorbeeld worden de SoapIncludeAttribute twee keer toegepast op een XML-webservicemethode. De methode retourneert een object van het type Vehicle (een basisklasse). Hiermee SoapIncludeAttribute kan de methode exemplaren van klassen retourneren die zijn afgeleid van de Vehicle klasse.

Opmerkingen

De SoapIncludeAttribute klasse behoort tot een reeks kenmerken die bepalen hoe de XmlSerializer serialiseren, of deserialisaties, een object als gecodeerde SOAP XML. De resulterende XML voldoet aan sectie 5 van het World Wide Web Consortium-document, SOAP (Simple Object Access Protocol) 1.1. Zie Attributes That Control Encoded SOAP Serialization voor een volledige lijst met vergelijkbare kenmerken.

Als u een object wilt serialiseren als een gecodeerd SOAP-bericht, moet u het XmlSerializer maken met behulp van een XmlTypeMapping gemaakt met de ImportTypeMapping methode van de SoapReflectionImporter klasse.

Geef bij het toepassen van de SoapIncludeAttributeafgeleide klasse de Type afgeleide klasse op. Wanneer de XmlSerializer objecten die zowel de basis als de afgeleide klassen bevatten, serialiseert, kunnen beide objecttypen vervolgens worden herkend.

U kunt afgeleide SoapIncludeAttribute klassen opnemen in servicebeschrijvingsdocumenten die zijn geschreven in de WSDL (Web Services Description Language). Als een methode bijvoorbeeld een Objectretourneert, past u de SoapIncludeAttribute methode toe op de methode en geeft u de werkelijke typen op die moeten worden geretourneerd.

Zie WSDL (World Wide Web Consortium Specification, Web Services Description Language) 1.1 voor meer informatie over WSDL.

Zie Kenmerken voor meer informatie over het gebruik van kenmerken.