SoapIncludeAttribute SoapIncludeAttribute SoapIncludeAttribute SoapIncludeAttribute Class

Definición

Permite que XmlSerializer reconozca un tipo al serializar o deserializar un objeto como XML SOAP codificado.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object as encoded SOAP XML.

public ref class SoapIncludeAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute
type SoapIncludeAttribute = class
    inherit Attribute
Public Class SoapIncludeAttribute
Inherits Attribute
Herencia
SoapIncludeAttributeSoapIncludeAttributeSoapIncludeAttributeSoapIncludeAttribute
Atributos

Ejemplos

En el ejemplo siguiente se SoapIncludeAttribute aplica el doble a un método de servicios Web XML.The following example applies the SoapIncludeAttribute twice to an XML Web service method. El método devuelve un objeto de tipo Vehicle (una clase base).The method returns an object of type Vehicle (a base class). Permite al método devolver instancias de clases derivadas de la Vehicle clase. SoapIncludeAttributeThe SoapIncludeAttribute allows the method to return instances of classes derived from the Vehicle class.

Comentarios

La SoapIncludeAttribute clase pertenece a una familia de atributos que controla XmlSerializer cómo serializa o deserializa un objeto como XML SOAP codificado.The SoapIncludeAttribute class belongs to a family of attributes that controls how the XmlSerializer serializes, or deserializes, an object as encoded SOAP XML. 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.The resulting XML conforms to section 5 of the World Wide Web Consortium document, Simple Object Access Protocol (SOAP) 1.1. Para obtener una lista completa de atributos similares, vea atributos que controlan la serialización SOAP codificada.For a complete list of similar attributes, see Attributes That Control Encoded SOAP Serialization.

Para serializar un objeto como un mensaje SOAP codificado XmlSerializer , debe construir XmlTypeMapping mediante creado con el ImportTypeMapping método de la SoapReflectionImporter clase.To serialize an object as an encoded SOAP message, you must construct the XmlSerializer using an XmlTypeMapping created with the ImportTypeMapping method of the SoapReflectionImporter class.

Al aplicar SoapIncludeAttribute, especifique el Type de la clase derivada.When applying the SoapIncludeAttribute, specify the Type of the derived class. XmlSerializer Cuando serializa objetos que incluyen las clases base y derivada, puede reconocer ambos tipos de objeto.When the XmlSerializer serializes objects that include both the base and the derived classes, it can then recognize both object types.

Puede usar el SoapIncludeAttribute para incluir clases derivadas en los documentos de descripción de servicio que se escriben en el lenguaje de descripción de servicios web (WSDL).You can use the SoapIncludeAttribute to include derived classes in service description documents that are written in the Web Services Description Language (WSDL). Por ejemplo, si un método devuelve Object, SoapIncludeAttribute se aplica al método y se especifican los tipos reales que se deben devolver.For example, if a method returns an Object, apply the SoapIncludeAttribute to the method and specify the actual types that should be returned.

Para obtener más información acerca de WSDL, vea World Wide Web Consortium Specification, Web Services Description Language (WSDL) 1,1.For more information about WSDL, see World Wide Web Consortium specification, Web Services Description Language (WSDL) 1.1.

Para obtener más información sobre el uso de atributos, vea atributos.For more information about using attributes, see Attributes.

Constructores

SoapIncludeAttribute(Type) SoapIncludeAttribute(Type) SoapIncludeAttribute(Type) SoapIncludeAttribute(Type)

Inicializa una nueva instancia de la clase SoapIncludeAttribute utilizando el tipo especificado.Initializes a new instance of the SoapIncludeAttribute class using the specified type.

Propiedades

Type Type Type Type

Obtiene o establece el tipo del objeto que debe utilizarse cuando se serializa o se deserializa un objeto.Gets or sets the type of the object to use when serializing or deserializing an object.

TypeId TypeId TypeId TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Devuelve un valor que indica si esta instancia es igual que un objeto especificado.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Devuelve el código hash de esta instancia.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _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.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Se aplica a