SoapDocumentServiceAttribute SoapDocumentServiceAttribute SoapDocumentServiceAttribute SoapDocumentServiceAttribute Class

Definición

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.Applying the optional SoapDocumentServiceAttribute to an XML Web service sets the default format of SOAP requests and responses sent to and from XML Web service methods within the XML Web service.

public ref class SoapDocumentServiceAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)]
[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class SoapDocumentServiceAttribute : Attribute
type SoapDocumentServiceAttribute = class
    inherit Attribute
Public NotInheritable Class SoapDocumentServiceAttribute
Inherits Attribute
Herencia
SoapDocumentServiceAttributeSoapDocumentServiceAttributeSoapDocumentServiceAttributeSoapDocumentServiceAttribute
Atributos

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 servicios Web XML en un servicio Web XML.The SoapDocumentServiceAttribute allows you to set the default formatting styles for XML Web service methods within an XML Web service. Si un método de servicios Web XML individual debe cambiar estos valores predeterminados SoapDocumentMethodAttribute , aplique a ese método de servicios Web XML.If an individual XML Web service method must change these defaults, apply a SoapDocumentMethodAttribute to that XML Web service method.

El lenguaje de descripción de servicios web (WSDL) define dos estilos para el modo en que se puede dar formato a un método de servicios Web XML, al que llama a una operación RPC , Documenten una solicitud SOAP o una respuesta SOAP: y.Web Services Description Language (WSDL) defines two styles for how an XML Web service method, which it calls an operation, can be formatted in a SOAP request or a SOAP response: RPC and Document. Exactamente cómo se determinan las partes individuales de Use los ParameterStyle mensajes mediante las propiedades y.Exactly how the individual message parts is determined by the Use and ParameterStyle properties. La Use propiedad determina si los parámetros tienen Encoded formato Literalo.The Use property determines whether parameters are formatted Encoded or Literal. Determina si los parámetros se encapsulan dentro de una sola parte del mensaje debajo Body del elemento, o si cada parámetro es una parte de mensaje individual. ParameterStyleThe ParameterStyle determines whether the parameters are encapsulated within a single message part beneath the Body element, or whether each parameter is an individual message part.

Para establecer el formato de nivel de método RPCpredeterminado en, SoapRpcServiceAttribute aplique a la clase que implementa el servicio Web XML.To set the default method level formatting to RPC, apply a SoapRpcServiceAttribute to the class implementing the XML Web service.

Para obtener más información, vea personalizar el formato de mensajes SOAP.For more details, see Customizing SOAP Message Formatting.

Este atributo se puede aplicar a una clase que implementa un servicio Web XML.This attribute can be applied to a class implementing an XML Web service.

Constructores

SoapDocumentServiceAttribute() SoapDocumentServiceAttribute() SoapDocumentServiceAttribute() SoapDocumentServiceAttribute()

Inicializa una nueva instancia de la clase SoapDocumentServiceAttribute, estableciendo todas las propiedades en sus valores predeterminados.Initializes a new instance of the SoapDocumentServiceAttribute class setting all properties to their default values.

SoapDocumentServiceAttribute(SoapBindingUse) SoapDocumentServiceAttribute(SoapBindingUse) SoapDocumentServiceAttribute(SoapBindingUse) SoapDocumentServiceAttribute(SoapBindingUse)

Inicializa una nueva instancia de la clase SoapDocumentServiceAttribute, estableciendo el formato de los parámetros.Initializes a new instance of the SoapDocumentServiceAttribute class setting the parameter formatting.

SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle) SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle) SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle) 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.Initializes a new instance of the SoapDocumentServiceAttribute class that sets the parameter formatting and sets whether parameters are encapsulated within a single XML element, under the Body element, in SOAP messages.

Propiedades

ParameterStyle ParameterStyle ParameterStyle 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.Gets or sets the default setting that controls whether parameters are encapsulated within a single element following the <Body> element in the XML portion of a SOAP message for XML Web service methods of the XML Web service.

RoutingStyle RoutingStyle RoutingStyle RoutingStyle

Obtiene o establece cómo se enrutan los mensajes SOAP al servicio Web XML.Gets or sets how SOAP messages are routed to the XML Web service.

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)
Use Use Use Use

Obtiene o establece el formato predeterminado de los parámetros de un servicio Web XML.Gets or sets the default parameter formatting for an XML Web service.

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

Consulte también: