WebServiceBindingAttribute Classe

Referência

Definição

Namespace:: System.Web.Services

Assembly:: System.Web.Services.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Declara uma associação que define um ou mais métodos do serviço Web XML. Essa classe não pode ser herdada.

public ref class WebServiceBindingAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true)]
public sealed class WebServiceBindingAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true)]
public sealed class WebServiceBindingAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true)>]
type WebServiceBindingAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true)>]
type WebServiceBindingAttribute = class
    inherit Attribute

Public NotInheritable Class WebServiceBindingAttribute
Inherits Attribute

Herança: Object

Attribute
WebServiceBindingAttribute

Atributos: AttributeUsageAttribute

Exemplos

O serviço Web XML a seguir implementa operações de quatro associações. Especificamente, o serviço Web XML declara três associações para as quais implementa operações, aplicando três WebServiceBindingAttribute atributos ao serviço Web XML.

Para especificar para qual associação um método de serviço Web XML está implementando uma operação, um é aplicado a cada um SoapDocumentMethodAttribute dos métodos de serviço Web XML, exceto DefaultBindingMethod. Ao não especificar uma associação para DefaultBindingMethod, ela está implementando uma operação na associação padrão para o serviço Web XML.

<%@ WebService Language="C#" class="BindingSample" %>
 using System;
 using System.Web.Services;
 using System.Web.Services.Protocols;

 // Binding is defined in this XML Web service and uses the default namespace.
 [ WebServiceBinding(Name="LocalBinding")]

 // Binding is defined in this XML Web service, but it is not a part of the default namespace.
 [ WebServiceBinding(Name="LocalBindingNonDefaultNamespace", 
             Namespace="http://www.contoso.com/MyBinding" )]

 // Binding is defined on a remote server, but this XML Web service implements at least one operation in that binding.
 [ WebServiceBinding(Name="RemoteBinding", 
          Namespace="http://www.contoso.com/MyBinding",
          Location="http://www.contoso.com/MySevice.asmx?wsdl")]
 public class BindingSample  {

      [ SoapDocumentMethod(Binding="LocalBinding")]
      [ WebMethod() ]
      public string LocalBindingMethod() {
               return "Member of binding defined in this XML Web service and member of the default namespace";
      }
      [ SoapDocumentMethod(Binding="LocalBindingNonDefaultNamespace")] 
      [ WebMethod() ]
      public string LocalBindingNonDefaultNamespaceMethod() {
              return "Member of binding defined in this XML Web service, but a part of a different namespace";
      }

     [ SoapDocumentMethod(Binding="RemoteBinding")] 
     [ WebMethod() ]
      public string RemoteBindingMethod() {
              return "Member of a binding defined on another server";
      }

      [ WebMethod() ]
      public string DefaultBindingMethod() {
              return "Member of the default binding";
      }
 
 }

<%@ WebService Language="VB" class="BindingSample" %>
Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols

' Binding is defined in this XML Web service and uses the default namespace.
' Binding is defined in this XML Web service, but it is not a part of the default
' namespace.
' Binding is defined on a remote server, but this XML Web service implements at
' least one operation in that binding.
<WebServiceBinding(Name := "LocalBinding"), _ 
 WebServiceBinding(Name := "LocalBindingNonDefaultNamespace", _ 
                   Namespace := "http://www.contoso.com/MyBinding"), _     
 WebServiceBinding(Name := "RemoteBinding", _ 
                   Namespace := "http://www.contoso.com/MyBinding", _
                   Location := "http://www.contoso.com/MySevice.asmx?wsdl")> _
Public Class BindingSample
    
    <SoapDocumentMethod(Binding := "LocalBinding"), WebMethod()> _
    Public Function LocalBindingMethod() As String
        
        Return "Member of binding defined in this XML Web service and member of the default namespace"
    End Function
    
    <SoapDocumentMethod(Binding := "LocalBindingNonDefaultNamespace"), WebMethod()> _
    Public Function LocalBindingNonDefaultNamespaceMethod() As String
    
        Return "Member o1f binding defined in this XML Web service, but a part of a different namespace"
    End Function    
    
    <SoapDocumentMethod(Binding := "RemoteBinding"), WebMethod()> _
    Public Function RemoteBindingMethod() As String
    
        Return "Member of a binding defined on another server"
    End Function    
    
    <WebMethod()> _
    Public Function DefaultBindingMethod() As String
    
        Return "Member of the default binding"
    End Function
End Class

Comentários

Uma associação, conforme definido pela WSDL (Linguagem de Descrição dos Serviços Web), é semelhante a uma interface, na medida em que define um conjunto concreto de operações. Cada método de serviço Web XML é uma operação dentro de uma associação específica. Os métodos de serviço Web XML são membros da associação padrão para um serviço Web XML ou de uma associação especificada em uma WebServiceBindingAttribute classe que implementa um serviço Web XML. Um serviço Web XML pode implementar várias associações aplicando vários WebServiceBindingAttribute atributos a um serviço Web XML.

Depois que um ou mais WebServiceAttribute atributos são aplicados a um serviço Web XML, um SoapDocumentMethodAttribute ou SoapRpcMethodAttribute pode ser aplicado a métodos de serviço Web XML individuais para indicar a operação de associação implementada por um método de serviço Web XML específico. Defina a Binding propriedade de SoapDocumentMethodAttribute ou SoapRpcMethodAttribute para especificar a associação para a qual um método de serviço Web XML está implementando uma operação.

Construtores

WebServiceBindingAttribute()	Inicializa uma nova instância da classe WebServiceBindingAttribute.
WebServiceBindingAttribute(String)	Inicializa uma nova instância da classe WebServiceBindingAttribute definindo o nome da associação que o método de serviço Web XML está implementando.
WebServiceBindingAttribute(String, String)	Inicializa uma nova instância da classe WebServiceBindingAttribute.
WebServiceBindingAttribute(String, String, String)	Inicializa uma nova instância da classe WebServiceBindingAttribute.

Propriedades

ConformsTo	Obtém ou define a especificação de WSI (Web Services Interoperability) à qual a associação declara estar em conformidade.
EmitConformanceClaims	Obtém ou define um valor que indica se a associação emite declarações de conformidade.
Location	Obtém ou define o local em que a associação está definida.
Name	Obtém ou define o nome da associação.
Namespace	Obtém ou define o namespace vinculado à associação.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface. (Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute)

Aplica-se a

Compartilhar via