SoapRpcMethodAttribute.Binding Eigenschap

Definitie

Haalt de binding op waarvoor een XML-webservicemethode een bewerking implementeert of stelt deze in.

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

Waarde van eigenschap

Met de binding voor een XML-webservicemethode wordt een bewerking geïmplementeerd. De standaardwaarde is de naam van de XML-webservice waaraan Soap is toegevoegd.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u meerdere bindingen in een XML-webservice implementeert.

<%@ 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

Opmerkingen

Een binding, zoals gedefinieerd door WSDL (Web Services Description Language), is vergelijkbaar met een interface waarin een concrete set bewerkingen wordt gedefinieerd. Met betrekking tot ASP.NET is elke XML-webservicemethode een bewerking binnen een binding. XML-webservicemethoden zijn lid van de standaardbinding voor een XML-webservice of een binding die is opgegeven in een WebServiceBindingAttribute toegepaste XML-webservice. Een XML-webservice kan meerdere bindingen implementeren als er meerdere WebServiceBindingAttribute kenmerken worden toegepast op een XML-webservice.

Zodra een of meer WebServiceBindingAttribute kenmerken zijn toegepast op een XML-webservice, kunnen een SoapDocumentMethodAttribute of SoapRpcMethodAttribute meer methoden worden toegepast op afzonderlijke XML-webservicemethoden om aan te geven welke bindingsbewerking is geïmplementeerd door een bepaalde XML-webservicemethode. Stel de Binding eigenschap van SoapDocumentMethodAttribute of SoapRpcMethodAttribute om de binding op te geven waarvoor een XML-webservicemethode een bewerking implementeert. Slechts één SoapDocumentMethodAttribute of SoapRpcMethodAttribute kunnen worden toegepast op een XML-webservicemethode. Daarom kan een XML-webservicemethode slechts een bewerking voor één binding implementeren.

Van toepassing op

Zie ook