Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

SoapIncludeAttribute (Clase)

Permite que XmlSerializer reconoce un tipo cuando serializa o deserializa un objeto mientras SOAP codificada XML.

System.Object
  System.Attribute
    System.Xml.Serialization.SoapIncludeAttribute

Espacio de nombres:  System.Xml.Serialization
Ensamblado:  System.Xml (en System.Xml.dll)

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

El tipo SoapIncludeAttribute expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con XNA FrameworkSoapIncludeAttributeInicializa una nueva instancia de la clase de SoapIncludeAttribute utilizando el tipo especificado.
Arriba

  NombreDescripción
Propiedad públicaCompatible con XNA FrameworkTypeObtiene o establece el tipo de objeto para utilizar al serializar o deserializar un objeto.
Propiedad públicaTypeIdCuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Se hereda de Attribute).
Arriba

  NombreDescripción
Método públicoCompatible con XNA FrameworkEqualsInfraestructura. Devuelve un valor que indica si esta instancia equivale al objeto especificado. (Se hereda de Attribute).
Método protegidoCompatible con XNA FrameworkFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkGetHashCodeDevuelve el código hash de esta instancia. (Se hereda de Attribute).
Método públicoCompatible con XNA FrameworkGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoIsDefaultAttributeCuando se invalida en una clase derivada, indica si el valor de esta instancia es el valor predeterminado para la clase derivada. (Se hereda de Attribute).
Método públicoCompatible con XNA FrameworkMatch Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Se hereda de Attribute).
Método protegidoCompatible con XNA FrameworkMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privado_Attribute.GetIDsOfNamesAsigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoObtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoCount

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.InvokeProporciona acceso a las propiedades y los métodos expuestos por un objeto. (Se hereda de Attribute).
Arriba

La clase de SoapIncludeAttribute pertenece a una familia de atributos que controla cómo XmlSerializer , serializa o deserializa, un objeto mientras SOAP codificada XML. XML resultante se ajusta a la sección 5 del documento de World Wide Web Consortium (www.w3.org), “el protocolo de acceso a objetos de (SOAP) Simple 1,1 ". Para obtener una lista completa de los atributos similares, vea Atributos que controlan la serialización SOAP codificada.

Para serializar un objeto como mensaje SOAP codificada, debe construir XmlSerializer mediante XmlTypeMapping creado con el método de ImportTypeMapping de la clase de SoapReflectionImporter .

Al aplicar SoapIncludeAttribute, especifique Type de la clase derivada. Cuando XmlSerializer serializa objetos que incluyen la base y las clases derivadas, podrá reconocer ambos tipos de objeto.

Puede utilizar SoapIncludeAttribute para incluir clases derivadas en los documentos de la descripción del servicio que se escriben en el Lenguaje de descripción de servicios (WSDL) web. Por ejemplo, si un método devuelve Object, aplique SoapIncludeAttribute al método y especifica los tipos reales que se deben devolver.

Para obtener más información acerca de WSDL, vea la especificación de World Wide Web Consortium (www.w3.org), “Lenguaje de descripción de (WSDL) servicios web 1,1 ".

Para obtener más información sobre el uso de atributos, vea Extender metadatos mediante atributos.

El ejemplo siguiente se aplica SoapIncludeAttribute dos veces a un método de servicio Web XML. El método devuelve un objeto de Vehicle tipo (una clase base). SoapIncludeAttribute permite que el método devuelva instancias de clases derivadas de la clase de Vehicle .


<%@ WebService Language="C#" Class="Test" %>

using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Services.Description;
using System.Xml;
using System.Xml.Schema;
using System.Xml.Serialization;
using System.Data;

public class Test : WebService {
   [WebMethod()]
   [return:XmlElement("MyTime", DataType="time")]
   public DateTime EchoString([XmlElement(DataType="string")] 
   string strval) {
        return DateTime.Now;
   }

   [WebMethod()]
   [SoapRpcMethod]
   [SoapInclude(typeof(Car)), SoapInclude(typeof(Bike))]
   public Vehicle Vehicle(string licenseNumber) {
      if (licenseNumber == "0") {
         Vehicle v = new Car();
         v.licenseNumber = licenseNumber;
         return v;
      }
      else if (licenseNumber == "1") {
          Vehicle v = new Bike();
          v.licenseNumber = licenseNumber;
          return v;
      }
      else {
         return null;
      }
   }
}
[XmlRoot("NewVehicle")] 
public abstract class Vehicle {
    public string licenseNumber;
    public DateTime make;
}

public class Car : Vehicle {
}

public class Bike : Vehicle {
}
   


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft