WebServiceBindingAttribute Classe

Definição

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, uma é aplicada a cada um SoapDocumentMethodAttribute dos métodos de serviço Web XML, exceto DefaultBindingMethod. Ao não especificar uma associação, DefaultBindingMethodela 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 Linguagem de Descrição dos Serviços Web (WSDL), é 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 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.

Uma vez 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.

Confira também

• SoapDocumentMethodAttribute
• SoapRpcMethodAttribute