SoapRpcMethodAttribute.Binding Proprietà

Definizione

Spazio dei nomi:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Ottiene o imposta l'associazione per cui un metodo di servizio Web XML implementa un'operazione.

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

Valore della proprietà

String

Associazione per cui un metodo di servizio Web XML implementa un'operazione. Il nome predefinito corrisponde al nome del servizio Web XML con l'aggiunta di "Soap".

Esempio

Nell'esempio di codice seguente viene illustrato come implementare più associazioni all'interno di un servizio 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

Commenti

Un'associazione, come definito dal linguaggio WSDL (Web Services Description Language), è simile a un'interfaccia in quanto definisce un set concreto di operazioni. Per quanto riguarda ASP.NET, ogni metodo di servizio Web XML è un'operazione all'interno di un'associazione. I metodi del servizio Web XML sono membri dell'associazione predefinita per un servizio Web XML o un'associazione specificata in un WebServiceBindingAttribute oggetto applicato a un servizio Web XML. Un servizio Web XML può implementare più associazioni, se più WebServiceBindingAttribute attributi vengono applicati a un servizio Web XML.

Dopo l'applicazione di uno o più WebServiceBindingAttribute attributi a un servizio Web XML, un SoapDocumentMethodAttribute oggetto o SoapRpcMethodAttribute può essere applicato ai singoli metodi del servizio Web XML per indicare l'operazione di associazione implementata da un metodo di servizio Web XML specifico. Impostare la Binding proprietà di SoapDocumentMethodAttribute o SoapRpcMethodAttribute per specificare l'associazione di un metodo di servizio Web XML implementa un'operazione per . Solo uno SoapDocumentMethodAttribute o SoapRpcMethodAttribute può essere applicato a un metodo di servizio Web XML. Pertanto, un metodo di servizio Web XML può implementare solo un'operazione per un'associazione.

Vedi anche

• WebServiceBindingAttribute