SoapRpcMethodAttribute.Binding Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.