SoapRpcMethodAttribute.Binding Propriété

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtient ou définit la liaison pour laquelle une méthode de service Web XML implémente une opération.

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

Valeur de propriété

String

Liaison pour laquelle une méthode de service Web XML implémente une opération. La valeur par défaut est le nom du service Web XML suivi de Soap.

Exemples

L’exemple de code suivant montre comment implémenter plusieurs liaisons au sein d’un service 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

Remarques

Une liaison, telle que définie par le langage WSDL (Web Services Description Language), est similaire à une interface dans laquelle elle définit un ensemble concret d’opérations. En ce qui concerne ASP.NET, chaque méthode de service Web XML est une opération dans une liaison. Les méthodes de service Web XML sont membres de la liaison par défaut d’un service Web XML ou d’une liaison spécifiée dans un WebServiceBindingAttribute service Web XML appliqué à un service Web XML. Un service Web XML peut implémenter plusieurs liaisons, si plusieurs WebServiceBindingAttribute attributs sont appliqués à un service Web XML.

Une fois qu’un ou plusieurs WebServiceBindingAttribute attributs sont appliqués à un service Web XML, un SoapDocumentMethodAttribute ou SoapRpcMethodAttribute peut être appliqué à des méthodes de service Web XML individuelles pour indiquer l’opération de liaison implémentée par une méthode de service Web XML particulière. Définissez la Binding propriété de SoapDocumentMethodAttribute ou SoapRpcMethodAttribute pour spécifier la liaison d’une méthode de service Web XML implémente une opération pour. Une seule ou SoapRpcMethodAttribute seule SoapDocumentMethodAttribute méthode de service web XML peut être appliquée. Par conséquent, une méthode de service Web XML ne peut implémenter qu’une opération pour une liaison.

Voir aussi

• WebServiceBindingAttribute