SoapRpcMethodAttribute.Binding Propiedad

Definición

Espacio de nombres:

System.Web.Services.Protocols

Ensamblado:

System.Web.Services.dll

Obtiene o establece el enlace para el que un método de servicios Web XML implementa una operación.

public:
 property System::String ^ Binding { System::String ^ get(); void set(System::String ^ value); };

public string Binding { get; set; }

member this.Binding : string with get, set

Public Property Binding As String

Valor de propiedad

String

Enlace para el que un método de servicios Web XML implementa una operación. El valor predeterminado es el nombre del servicio Web XML seguido de "Soap".

Ejemplos

En el ejemplo de código siguiente se muestra cómo implementar varios enlaces dentro de un servicio 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 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  {

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

     [ SoapRpcMethodAttribute(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.Web.Services
 Imports System.Web.Services.Protocols

 ' Three bindings are defined
   < 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  

      < SoapRpcMethod(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

          < SoapRpcMethodAttribute(Binding:="LocalBindingNonDefaultNamespace"), WebMethod > _
      Public Function LocalBindingNonDefaultNamespaceMethod() As String
        Return "Member of binding defined in this XML Web service, but a part of a different namespace"
      End Function
    
          < SoapRpcMethodAttribute(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

Comentarios

Un enlace, tal como se define en el Lenguaje de descripción de servicios web (WSDL), es similar a una interfaz en la que define un conjunto concreto de operaciones. Con respecto a ASP.NET, cada método de servicio web XML es una operación dentro de un enlace. Los métodos de servicio web XML son miembros del enlace predeterminado para un servicio web XML o un enlace especificado en un WebServiceBindingAttribute servicio web XML aplicado a un servicio web XML. Un servicio web XML puede implementar varios enlaces, si se aplican varios WebServiceBindingAttribute atributos a un servicio web XML.

Una vez que uno o varios WebServiceBindingAttribute atributos se aplican a un servicio web XML, SoapDocumentMethodAttribute o SoapRpcMethodAttribute se pueden aplicar a métodos de servicio web XML individuales para indicar la operación de enlace implementada por un método de servicio web XML determinado. Establezca la Binding propiedad de SoapDocumentMethodAttribute o SoapRpcMethodAttribute para especificar el enlace de un método de servicio web XML para el que implementa una operación. Solo se puede aplicar una SoapDocumentMethodAttribute o SoapRpcMethodAttribute a un método de servicio web XML. Por lo tanto, un método de servicio web XML solo puede implementar una operación para un enlace.

Consulte también

• WebServiceBindingAttribute