WebServiceBindingAttribute Klas

Definitie

public ref class WebServiceBindingAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true)]
public sealed class WebServiceBindingAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true)]
public sealed class WebServiceBindingAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true)>]
type WebServiceBindingAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true)>]
type WebServiceBindingAttribute = class
    inherit Attribute

Public NotInheritable Class WebServiceBindingAttribute
Inherits Attribute

Overname

Object

Attribute

WebServiceBindingAttribute

Kenmerken

AttributeUsageAttribute

Voorbeelden

Met de volgende XML-webservice worden bewerkingen van vier bindingen geïmplementeerd. De XML-webservice declareert met name drie bindingen waarvoor bewerkingen worden geïmplementeerd door drie WebServiceBindingAttribute kenmerken toe te passen op de XML-webservice.

Als u wilt opgeven voor welke binding een XML-webservicemethode een bewerking implementeert, wordt er een SoapDocumentMethodAttribute toegepast op elk van de XML-webservicemethoden, met uitzondering DefaultBindingMethodvan . Door geen binding DefaultBindingMethodvoor op te geven, wordt er een bewerking geïmplementeerd op de standaardbinding voor de XML-webservice.

<%@ 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="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  {

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

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

' Binding is defined in this XML Web service and uses the default namespace.
' Binding is defined in this XML Web service, but it is not a part of the default
' namespace.
' Binding is defined on a remote server, but this XML Web service implements at
' least one operation in that binding.
<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
    
    <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
    
    <SoapDocumentMethod(Binding := "LocalBindingNonDefaultNamespace"), WebMethod()> _
    Public Function LocalBindingNonDefaultNamespaceMethod() As String
    
        Return "Member o1f binding defined in this XML Web service, but a part of a different namespace"
    End Function    
    
    <SoapDocumentMethod(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, omdat hiermee een concrete set bewerkingen wordt gedefinieerd. Elke XML-webservicemethode is een bewerking binnen een bepaalde binding. XML-webservicemethoden zijn lid van de standaardbinding voor een XML-webservice of een binding die is opgegeven in een WebServiceBindingAttribute klasse die een XML-webservice implementeert. Een XML-webservice kan meerdere bindingen implementeren door meerdere WebServiceBindingAttribute kenmerken toe te passen op een XML-webservice.

Zodra een of meer WebServiceAttribute 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 wordt geïmplementeerd.

Zie ook

• SoapDocumentMethodAttribute
• SoapRpcMethodAttribute