SoapRpcMethodAttribute.Binding Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger bindningen som en XML-webbtjänstmetod implementerar en åtgärd för.
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
Egenskapsvärde
Bindningen av en XML-webbtjänstmetod implementerar en åtgärd för. Standardvärdet är namnet på XML-webbtjänsten med "Soap" som läggs till.
Exempel
Följande kodexempel visar hur du implementerar flera bindningar i en XML-webbtjänst.
<%@ 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
Kommentarer
En bindning, som definieras av Web Services Description Language (WSDL), liknar ett gränssnitt eftersom den definierar en konkret uppsättning åtgärder. När det gäller ASP.NET är varje XML-webbtjänstmetod en åtgärd inom en bindning. XML-webbtjänstmetoder är medlemmar i standardbindningen för en XML-webbtjänst eller en bindning som anges i en WebServiceBindingAttribute som tillämpas på en XML-webbtjänst. En XML-webbtjänst kan implementera flera bindningar om flera WebServiceBindingAttribute attribut tillämpas på en XML-webbtjänst.
När ett eller flera WebServiceBindingAttribute attribut har tillämpats på en XML-webbtjänst kan en SoapDocumentMethodAttribute eller SoapRpcMethodAttribute tillämpas på enskilda XML-webbtjänstmetoder för att ange bindningsåtgärden som implementeras av en viss XML-webbtjänstmetod. Binding Ange egenskapen SoapDocumentMethodAttribute för eller SoapRpcMethodAttribute för att ange bindningen för en XML-webbtjänstmetod som implementerar en åtgärd för. Endast en SoapDocumentMethodAttribute eller SoapRpcMethodAttribute kan tillämpas på en XML-webbtjänstmetod. Därför kan en XML-webbtjänstmetod bara implementera en åtgärd för en bindning.