SoapIncludeAttribute Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Permite que o XmlSerializer reconheça um tipo quando serializa ou desserializa um objeto como SOAP XML codificado.
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 AttributePublic Class SoapIncludeAttribute
Inherits Attribute- Herança
- Atributos
Exemplos
O exemplo a seguir aplica as SoapIncludeAttribute duas vezes a um método de serviço Web XML. O método retorna um objeto do tipo Vehicle (uma classe base). Permite SoapIncludeAttribute que o método retorne instâncias de classes derivadas da Vehicle classe.
Comentários
A SoapIncludeAttribute classe pertence a uma família de atributos que controla como o XmlSerializer serializa ou desserializa um objeto como XML SOAP codificado. O XML resultante está em conformidade com a seção 5 do documento do World Wide Web Consortium, Simple Object Access Protocol (SOAP) 1.1. Para obter uma lista completa de atributos semelhantes, consulte Atributos que controlam a serialização SOAP codificada.
Para serializar um objeto como uma mensagem SOAP codificada, você deve construir o XmlSerializer uso de um XmlTypeMapping criado com o ImportTypeMapping método da SoapReflectionImporter classe.
Ao aplicar o SoapIncludeAttribute, especifique a Type classe derivada. Quando os XmlSerializer objetos serializam a base e as classes derivadas, ela pode reconhecer ambos os tipos de objeto.
Você pode usar as SoapIncludeAttribute classes derivadas para incluir em documentos de descrição de serviço que são escritos na Linguagem de Descrição dos Serviços Web (WSDL). Por exemplo, se um método retornar um Object, aplique o SoapIncludeAttribute método e especifique os tipos reais que devem ser retornados.
Para obter mais informações sobre o WSDL, consulte a especificação do World Wide Web Consortium, Linguagem de Descrição dos Serviços Web (WSDL) 1.1.
Para obter mais informações sobre como usar atributos, consulte Atributos.
Construtores
| Nome | Description |
|---|---|
| SoapIncludeAttribute(Type) |
Inicializa uma nova instância da SoapIncludeAttribute classe usando o tipo especificado. |
Propriedades
| Nome | Description |
|---|---|
| Type |
Obtém ou define o tipo do objeto a ser usado ao serializar ou desserializar um objeto. |
| TypeId |
Quando implementado em uma classe derivada, obtém um identificador exclusivo para esse Attribute. (Herdado de Attribute) |
Métodos
| Nome | Description |
|---|---|
| Equals(Object) |
Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute) |
| GetHashCode() |
Devolve o código hash para esta instância. (Herdado de Attribute) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IsDefaultAttribute() |
Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute) |
| Match(Object) |
Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Recupera as informações de tipo de um objeto, que podem ser usadas para obter as informações de tipo de uma interface. (Herdado de Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute) |