SoapIncludeAttribute Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Permite que XmlSerializer reconozca un tipo al serializar o deserializar un objeto como XML SOAP codificado.
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 AttributePublic Class SoapIncludeAttribute
Inherits Attribute- Herencia
- Atributos
Ejemplos
En el ejemplo siguiente se aplica dos SoapIncludeAttribute veces a un método de servicio web XML. El método devuelve un objeto de tipo Vehicle (una clase base).
SoapIncludeAttribute permite que el método devuelva instancias de clases derivadas de la Vehicle clase .
Comentarios
La SoapIncludeAttribute clase pertenece a una familia de atributos que controla cómo XmlSerializer serializa o deserializa un objeto como XML SOAP codificado. El XML resultante se ajusta a la sección 5 del documento World Wide Web Consortium, Protocolo simple de acceso a objetos (SOAP) 1.1. Para obtener una lista completa de atributos similares, vea Atributos que controlan la serialización SOAP codificada.
Para serializar un objeto como un mensaje SOAP codificado, debe construir mediante XmlSerializer un XmlTypeMapping creado con el ImportTypeMapping método de la SoapReflectionImporter clase .
Al aplicar SoapIncludeAttribute, especifique el Type objeto de la clase derivada. Cuando serializa XmlSerializer los objetos que incluyen las clases base y derivadas, puede reconocer ambos tipos de objeto.
Puede usar SoapIncludeAttribute para incluir clases derivadas en documentos de descripción del servicio escritos en el lenguaje de descripción de servicios web (WSDL). Por ejemplo, si un método devuelve , Objectaplique al SoapIncludeAttribute método y especifique los tipos reales que se deben devolver.
Para obtener más información sobre WSDL, vea Especificación de World Wide Web Consortium, Lenguaje de descripción de servicios web (WSDL) 1.1.
Para obtener más información sobre el uso de atributos, vea Atributos.
Constructores
| SoapIncludeAttribute(Type) |
Inicializa una nueva instancia de la clase SoapIncludeAttribute utilizando el tipo especificado. |
Propiedades
| Type |
Obtiene o establece el tipo del objeto que debe utilizarse cuando se serializa o se deserializa un objeto. |
| TypeId |
Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute) |
Métodos
| Equals(Object) |
Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute) |
| GetHashCode() |
Devuelve el código hash de esta instancia. (Heredado de Attribute) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| IsDefaultAttribute() |
Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute) |
| Match(Object) |
Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Implementaciones de interfaz explícitas
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Heredado de Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Heredado de Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). (Heredado de Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Proporciona acceso a las propiedades y los métodos expuestos por un objeto. (Heredado de Attribute) |
