SoapDocumentMethodAttribute.Binding-Eigenschaft

Ruft den Namen einer Bindung ab, für die eine XML-Webdienstmethode einen Vorgang implementiert, oder legt diesen fest.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Property Binding As String
'Usage
Dim instance As SoapDocumentMethodAttribute
Dim value As String

value = instance.Binding

instance.Binding = value

public string Binding { get; set; }

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

/** @property */
public String get_Binding ()

/** @property */
public void set_Binding (String value)

public function get Binding () : String

public function set Binding (value : String)

Eigenschaftenwert

Die Bindung, für die eine XML-Webdienstmethode einen Vorgang implementiert. Als Standardname wird der Name des XML-Webdiensts verwendet, an den "Soap" angehängt wird.

Hinweise

Nach der WSDL-Definition (Web Services Description Language) ist die Bindung einer Schnittstelle ähnlich, da sie eine konkrete Gruppe von Vorgängen definiert. In Bezug auf XML-Webdienste, die mithilfe von ASP.NET erstellt wurden, ist jede XML-Webdienstmethode ein Vorgang innerhalb einer Bindung. XML-Webdienstmethoden sind entweder Member der Standardbindung für einen XML-Webdienst oder einer innerhalb eines WebServiceBindingAttribute angegebenen Bindung, das auf einen XML-Webdienst angewendet wird. Ein XML-Webdienst kann mehrere Bindungen implementieren, wenn einem XML-Webdienst mehrere WebServiceBindingAttribute-Attribute zugewiesen werden.

Wenn einem XML-Webdienst ein oder mehrere WebServiceBindingAttribute-Attribute zugewiesen wurden, können einzelnen XML-Webdienstmethoden ein SoapDocumentMethodAttribute oder ein SoapRpcMethodAttribute zugewiesen werden, um den durch eine bestimmte XML-Webdienstmethode implementierten Bindungsvorgang anzugeben. Legen Sie die Binding-Eigenschaft von SoapDocumentMethodAttribute oder SoapRpcMethodAttribute fest, um die Bindung anzugeben, für die eine XML-Webdienstmethode einen Vorgang implementiert. Einer XML-Webdienstmethode kann nur ein SoapDocumentMethodAttribute bzw. ein SoapRpcMethodAttribute zugewiesen werden. Demzufolge kann eine XML-Webdienstmethode nur einen Vorgang für eine Bindung implementieren.

Weitere Informationen über die WSDL-Spezifikation finden Sie auf der W3C-Website unter http://www.w3.org/TR/wsdl (nur auf Englisch verfügbar).

Beispiel

<%@ 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:="https://www.contoso.com/MyBinding"), _
   WebServiceBinding(Name:="RemoteBinding",Namespace:="https://www.contoso.com/MyBinding",Location:="https://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

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

<%@ 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="https://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="https://www.contoso.com/MyBinding",                      Location="https://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";
      }
      [ SoapDocumentMethodAttribute(Binding="LocalBindingNonDefaultNamespace")] 
      [ WebMethod ]
      public string LocalBindingNonDefaultNamespaceMethod() {
            return "Member of binding defined in this XML Web service, but a part of a different namespace.";
      }

     [ SoapDocumentMethodAttribute(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.";
      }
 
 }   

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SoapDocumentMethodAttribute-Klasse
SoapDocumentMethodAttribute-Member
System.Web.Services.Protocols-Namespace
WebServiceBindingAttribute-Klasse