SoapRpcMethodAttribute.Binding Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает привязку, для которой метод веб-службы XML реализует операцию.
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
Значение свойства
Привязка, для которой метод веб-службы XML реализует операцию. По умолчанию это имя веб-службы XML с добавлением "Soap".
Примеры
В следующем примере кода показано, как реализовать несколько привязок в веб-службе 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
Комментарии
Привязка, определяемая языком описания веб-служб (WSDL), аналогична интерфейсу, который определяет конкретный набор операций. Что касается ASP.NET, каждый метод веб-службы XML является операцией в привязке. Методы веб-службы XML являются элементами привязки по умолчанию для веб-службы XML или привязки, указанной WebServiceBindingAttribute в приложении к веб-службе XML. Веб-служба XML может реализовать несколько привязок, если к веб-службе XML применяются несколько WebServiceBindingAttribute атрибутов.
После применения одного или нескольких WebServiceBindingAttribute атрибутов к веб-службе XML можно применить к SoapRpcMethodAttribute отдельным методам веб-службы XML, чтобы указать операцию привязки, SoapDocumentMethodAttribute реализованную определенным методом веб-службы XML. Binding Задайте свойство или SoapRpcMethodAttribute указание привязки SoapDocumentMethodAttribute метода веб-службы XML реализует операцию. Только один SoapDocumentMethodAttribute или SoapRpcMethodAttribute может применяться к методу веб-службы XML. Таким образом, метод веб-службы XML может реализовать только операцию для одной привязки.