SoapDocumentServiceAttribute Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Aplicar o opcional SoapDocumentServiceAttribute a um serviço Web XML define o formato padrão dos pedidos e respostas SOAP enviados para e dos métodos do serviço Web XML dentro do serviço 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 AttributePublic NotInheritable Class SoapDocumentServiceAttribute
Inherits Attribute- Herança
- Atributos
Exemplos
<%@ 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
Observações
Permite-lhe SoapDocumentServiceAttribute definir os estilos de formatação predefinidos para métodos de serviço Web XML dentro de um serviço Web XML. Se um método individual de serviço Web XML tiver de alterar estes predefinidos, aplique a SoapDocumentMethodAttribute a a esse método de serviço Web XML.
A Linguagem de Descrição de Serviços Web (WSDL) define dois estilos para como um método de serviço Web XML, que chama de operação, pode ser formatado num pedido SOAP ou numa resposta SOAP: RPC e Document. A forma como as partes individuais da mensagem é determinada pelas Use propriedades e.ParameterStyle A Use propriedade determina se os parâmetros são formatados Encoded ou Literal. Determina ParameterStyle se os parâmetros estão encapsulados numa única parte da mensagem abaixo do Body elemento, ou se cada parâmetro é uma parte individual da mensagem.
Para definir a formatação padrão ao nível do método para RPC, aplica a SoapRpcServiceAttribute à classe que implementa o serviço Web XML.
Para mais detalhes, consulte Personalização da Formatação de Mensagens SOAP.
Este atributo pode ser aplicado a uma classe que implementa um serviço Web XML.
Construtores
| Name | Description |
|---|---|
| SoapDocumentServiceAttribute() |
Inicializa uma nova instância da SoapDocumentServiceAttribute classe que define todas as propriedades para os seus valores padrão. |
| SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle) |
Inicializa uma nova instância da SoapDocumentServiceAttribute classe que define a formatação dos parâmetros e define se os parâmetros estão encapsulados num único elemento XML, sob o |
| SoapDocumentServiceAttribute(SoapBindingUse) |
Inicializa uma nova instância da SoapDocumentServiceAttribute classe que define a formatação dos parâmetros. |
Propriedades
| Name | Description |
|---|---|
| ParameterStyle |
Obtém ou define a definição padrão que controla se os parâmetros estão encapsulados num único elemento após o |
| RoutingStyle |
Obtém ou define como as mensagens SOAP são encaminhadas para o serviço Web XML. |
| TypeId |
Quando implementado numa classe derivada, obtém um identificador único para esta Attribute. (Herdado de Attribute) |
| Use |
Obtém ou define a formatação de parâmetros padrão para um serviço Web XML. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Devolve um valor que indica se esta instância é igual a um objeto especificado. (Herdado de Attribute) |
| GetHashCode() |
Devolve o código de hash para esta instância. (Herdado de Attribute) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IsDefaultAttribute() |
Quando sobrescrito numa classe derivada, indica se o valor desta instância é o valor padrão para a classe derivada. (Herdado de Attribute) |
| Match(Object) |
Quando sobrescrito numa classe derivada, devolve um valor que indica se esta instância é igual a um objeto especificado. (Herdado de Attribute) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de despacho. (Herdado de Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Recupera a informação de tipo de um objeto, que pode ser usada para obter a informação de tipo para uma interface. (Herdado de Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Recupera o número de interfaces de informações de tipo que um objeto fornece (0 ou 1). (Herdado de Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Proporciona acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute) |