SoapDocumentServiceAttribute Clase

Referencia

Definición

Espacio de nombres:: System.Web.Services.Protocols

Ensamblado:: System.Web.Services.dll

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í.

Si se aplica el SoapDocumentServiceAttribute opcional a un servicio Web XML, se establece el formato predeterminado de las solicitudes SOAP de los métodos de servicios Web XML y las respuestas SOAP a estos métodos en el servicio Web XML.

public ref class SoapDocumentServiceAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class SoapDocumentServiceAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type SoapDocumentServiceAttribute = class
    inherit Attribute

Public NotInheritable Class SoapDocumentServiceAttribute
Inherits Attribute

Herencia: Object

Attribute
SoapDocumentServiceAttribute

Atributos: AttributeUsageAttribute

Ejemplos

<%@ WebService Language="c#" Class="SumService" %>

using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Services.Description;

    [SoapDocumentService(SoapBindingUse.Literal,
                         SoapParameterStyle.Wrapped,
                         RoutingStyle=SoapServiceRoutingStyle.SoapAction)]
    public class SumService : System.Web.Services.WebService
    {
        [WebMethod]
        public int Add(int a, int b)
        {
            return a + b;
        }
    }

<%@ WebService Language="VB" Class="SumService" %>

Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Web.Services.Description

    <SoapDocumentService(SoapBindingUse.Literal, _
                             SoapParameterStyle.Wrapped, _
                             RoutingStyle := SoapServiceRoutingStyle.SoapAction)> _
    Public Class SumService 
          Inherits System.Web.Services.WebService
    
        <WebMethod> _
        Public Function Add(a As Integer, b as Integer)
           return a + b
        End Function
    End Class

Comentarios

SoapDocumentServiceAttribute permite establecer los estilos de formato predeterminados para los métodos de servicio web XML dentro de un servicio web XML. Si un método de servicio web XML individual debe cambiar estos valores predeterminados, aplique a SoapDocumentMethodAttribute ese método de servicio web XML.

Lenguaje de descripción de servicios web (WSDL) define dos estilos para cómo un método de servicio web XML, al que llama a una operación, se puede dar formato a una solicitud SOAP o una respuesta SOAP: RPC y Document. Exactamente cómo determinan las propiedades y ParameterStyle las Use partes del mensaje individuales. La Use propiedad determina si los parámetros tienen formato Encoded o Literal. ParameterStyle determina si los parámetros se encapsulan dentro de una sola parte de mensaje debajo del Body elemento o si cada parámetro es una parte de mensaje individual.

Para establecer el formato de nivel de método predeterminado en RPC, aplique a SoapRpcServiceAttribute la clase que implementa el servicio web XML.

Para obtener más información, consulte Personalización del formato de mensajes SOAP.

Este atributo se puede aplicar a una clase que implementa un servicio web XML.

Constructores

SoapDocumentServiceAttribute()	Inicializa una nueva instancia de la clase SoapDocumentServiceAttribute, estableciendo todas las propiedades en sus valores predeterminados.
SoapDocumentServiceAttribute(SoapBindingUse)	Inicializa una nueva instancia de la clase SoapDocumentServiceAttribute, estableciendo el formato de los parámetros.
SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)	Inicializa una nueva instancia de la clase SoapDocumentServiceAttribute que establece el formato de los parámetros y si los parámetros se encapsulan en un único elemento XML, debajo del elemento `Body`, en los mensajes SOAP.

Propiedades

ParameterStyle	Obtiene o establece la configuración predeterminada que controla si los parámetros se encapsulan en un único elemento, que va a continuación del elemento `<Body>`, en la parte XML de un mensaje SOAP para los métodos de servicios Web XML del servicio Web XML.
RoutingStyle	Obtiene o establece cómo se enrutan los mensajes SOAP al servicio Web XML.
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)
Use	Obtiene o establece el formato predeterminado de los parámetros de un servicio Web XML.

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)

Se aplica a

Comparteix a través de