SoapRpcMethodAttribute.Binding Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
XML Web hizmeti yönteminin bir işlemi uyguladığı bağlamayı alır veya ayarlar.
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
Özellik Değeri
XML Web hizmeti yöntemini bağlama işlemi için bir işlem uygular. Varsayılan, "Soap" eklenmiş XML Web hizmetinin adıdır.
Örnekler
Aşağıdaki kod örneği, XML Web hizmeti içinde birden çok bağlamanın nasıl uygulanduğunu gösterir.
<%@ 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
Açıklamalar
Web Hizmetleri Açıklama Dili (WSDL) tarafından tanımlanan bağlama, somut bir işlem kümesi tanımladığı arabirime benzer. ASP.NET açısından, her XML Web hizmeti yöntemi bağlama içindeki bir işlemdir. XML Web hizmeti yöntemleri, XML Web hizmeti için varsayılan bağlamanın veya XML Web hizmetine uygulanan içinde belirtilen bağlamanın WebServiceBindingAttribute üyeleridir. XML Web hizmetine birden çok öznitelik uygulandığında, XML Web hizmeti birden çok WebServiceBindingAttribute bağlama uygulayabilir.
Xml Web hizmetine bir veya daha fazla WebServiceBindingAttribute öznitelik uygulandıktan sonra, belirli bir SoapDocumentMethodAttribute SoapRpcMethodAttribute XML Web hizmeti yöntemi tarafından uygulanan bağlama işlemini belirtmek için tek tek XML Web hizmeti yöntemlerine veya uygulanabilir. Binding bir XML Web hizmeti yönteminin SoapDocumentMethodAttribute bir işlemi uyguladığı bağlamayı belirtmek için veya SoapRpcMethodAttribute özelliğini ayarlayın. SoapDocumentMethodAttribute XML Web hizmeti yöntemine yalnızca bir veya SoapRpcMethodAttribute uygulanabilir. Bu nedenle, XML Web hizmeti yöntemi yalnızca bir bağlama için bir işlem uygulayabilir.