SoapRpcMethodAttribute.Binding Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a ligação para a qual um método de serviço Web XML implementa uma operação.
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
Valor de Propriedade
A ligação de um método de serviço Web XML implementa uma operação para. O padrão é o nome do serviço Web XML com "Soap" acrescentado.
Exemplos
O exemplo de código seguinte demonstra como implementar múltiplas ligações dentro de um serviço 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
Observações
Um binding, conforme definido pela Web Services Description Language (WSDL), é semelhante a uma interface no sentido em que define um conjunto concreto de operações. No que diz respeito ao ASP.NET, cada método de serviço Web XML é uma operação dentro de um binding. Os métodos de serviço Web XML são membros da binding padrão para um serviço Web XML ou de uma binding especificada dentro de aplicada WebServiceBindingAttribute a um serviço Web XML. Um serviço Web XML pode implementar múltiplos bindings, se múltiplos WebServiceBindingAttribute atributos forem aplicados a um serviço Web XML.
Uma vez que um ou mais WebServiceBindingAttribute atributos são aplicados a um serviço Web XML, um SoapDocumentMethodAttribute ou SoapRpcMethodAttribute pode ser aplicado a métodos individuais de serviço Web XML para indicar a operação de ligação implementada por um determinado método de serviço Web XML. Defina a Binding propriedade de SoapDocumentMethodAttribute ou SoapRpcMethodAttribute para especificar a ligação que um método de serviço Web XML implementa uma operação para. Apenas um SoapDocumentMethodAttribute ou SoapRpcMethodAttribute pode ser aplicado a um método de serviço Web XML. Portanto, um método de serviço Web XML só pode implementar uma operação para uma ligação.