SoapIncludeAttribute Classe

Definição

public ref 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)]
public class SoapIncludeAttribute : Attribute

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

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

Public Class SoapIncludeAttribute
Inherits Attribute

Herança

Object

Attribute

SoapIncludeAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo seguinte aplica o SoapIncludeAttribute twice a um método de serviço Web XML. O método devolve um objeto do tipo Vehicle (uma classe base). Permite SoapIncludeAttribute ao método devolver instâncias de classes derivadas da Vehicle classe.

Observações

A SoapIncludeAttribute classe pertence a uma família de atributos que controla como serializa XmlSerializer , ou desserializa, um objeto codificado como SOAP XML. O XML resultante cumpre a secção 5 do documento do World Wide Web Consortium, Simple Object Access Protocol (SOAP) 1.1. Para uma lista completa de atributos semelhantes, veja Atributos que Controlam a Serialização SOAP Codificada.

Para serializar um objeto como uma mensagem SOAP codificada, deve construir o XmlSerializer usando um XmlTypeMapping criado com o ImportTypeMapping método da SoapReflectionImporter classe.

Ao aplicar o SoapIncludeAttribute, especifique o Type da classe derivada. Quando serializa XmlSerializer objetos que incluem tanto as classes base como as derivadas, pode então reconhecer ambos os tipos de objetos.

Pode usar o SoapIncludeAttribute para incluir classes derivadas em documentos de descrição de serviços escritos na Web Services Description Language (WSDL). Por exemplo, se um método devolve um Object, aplica o SoapIncludeAttribute ao método e especifica os tipos reais que devem ser devolvidos.

Para mais informações sobre WSDL, consulte a especificação do World Wide Web Consortium, Web Services Description Language (WSDL) 1.1.

Para mais informações sobre o uso de atributos, consulte Atributos.