WebServiceBindingAttribute Sınıf

Tanım

Ad Alanı:

System.Web.Services

Bütünleştirilmiş Kod:

System.Web.Services.dll

Bir veya daha fazla XML Web hizmeti yöntemini tanımlayan bir bağlama bildirir. Bu sınıf devralınamaz.

public ref class WebServiceBindingAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true)]
public sealed class WebServiceBindingAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, AllowMultiple=true)>]
type WebServiceBindingAttribute = class
    inherit Attribute

Public NotInheritable Class WebServiceBindingAttribute
Inherits Attribute

Devralma

Object

Attribute

WebServiceBindingAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki XML Web hizmeti dört bağlamadan işlemleri uygular. Özel olarak, XML Web hizmeti, XML Web hizmetine üç öznitelik uygulayarak işlemleri uyguladığı üç WebServiceBindingAttribute bağlama bildirir.

XML Web hizmeti yönteminin hangi bağlama için bir işlem uyguladığını belirtmek için, dışında DefaultBindingMethodXML Web hizmeti yöntemlerinin her birine bir SoapDocumentMethodAttribute uygulanır. için DefaultBindingMethodbir bağlama belirtmeyerek, XML Web hizmeti için varsayılan bağlamaya bir işlem uygular.

<%@ 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 it is 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  {

      [ SoapDocumentMethod(Binding="LocalBinding")]
      [ WebMethod() ]
      public string LocalBindingMethod() {
               return "Member of binding defined in this XML Web service and member of the default namespace";
      }
      [ SoapDocumentMethod(Binding="LocalBindingNonDefaultNamespace")] 
      [ WebMethod() ]
      public string LocalBindingNonDefaultNamespaceMethod() {
              return "Member of binding defined in this XML Web service, but a part of a different namespace";
      }

     [ SoapDocumentMethod(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
Imports System.Web.Services
Imports System.Web.Services.Protocols

' Binding is defined in this XML Web service and uses the default namespace.
' Binding is defined in this XML Web service, but it is not a part of the default
' namespace.
' Binding is defined on a remote server, but this XML Web service implements at
' least one operation in that binding.
<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
    
    <SoapDocumentMethod(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
    
    <SoapDocumentMethod(Binding := "LocalBindingNonDefaultNamespace"), WebMethod()> _
    Public Function LocalBindingNonDefaultNamespaceMethod() As String
    
        Return "Member o1f binding defined in this XML Web service, but a part of a different namespace"
    End Function    
    
    <SoapDocumentMethod(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ığı bir arabirime benzer. Her XML Web hizmeti yöntemi, belirli bir 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 hizmeti uygulayan bir sınıfa uygulanan içinde WebServiceBindingAttribute belirtilen bağlamanın üyeleridir. XML Web hizmeti, XML Web hizmetine birden çok öznitelik uygulayarak birden çok WebServiceBindingAttribute bağlama uygulayabilir.

Xml Web hizmetine bir veya daha fazla WebServiceAttribute öznitelik uygulandıktan sonra, belirli bir SoapDocumentMethodAttribute XML Web hizmeti yöntemi tarafından uygulanan bağlama işlemini göstermek için tek tek XML Web hizmeti yöntemlerine veya SoapRpcMethodAttribute uygulanabilir. bir XML Web hizmeti yönteminin BindingSoapDocumentMethodAttribute bir işlemi uyguladığı bağlamayı belirtmek için veya SoapRpcMethodAttribute özelliğini ayarlayın.

Oluşturucular

Name	Description
WebServiceBindingAttribute()	WebServiceBindingAttribute sınıfının yeni bir örneğini başlatır.
WebServiceBindingAttribute(String, String, String)	WebServiceBindingAttribute sınıfının yeni bir örneğini başlatır.
WebServiceBindingAttribute(String, String)	WebServiceBindingAttribute sınıfının yeni bir örneğini başlatır.
WebServiceBindingAttribute(String)	XML Web hizmeti yönteminin WebServiceBindingAttribute uyguladığı bağlamanın adını ayarlayarak sınıfın yeni bir örneğini başlatır.

Özellikler

Name	Description
ConformsTo	Bağlamanın uygun olduğunu iddia ettiği Web Hizmetleri Birlikte Çalışabilirlik (WSI) belirtimini alır veya ayarlar.
EmitConformanceClaims	Bağlamanın uyumluluk talepleri yayıp yaymadığını gösteren bir değer alır veya ayarlar.
Location	Bağlamanın tanımlandığı konumu alır veya ayarlar.
Name	Bağlamanın adını alır veya ayarlar.
Namespace	Bağlamayla ilişkili ad alanını alır veya ayarlar.
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)

Yöntemler

Name	Description
Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğin karma kodunu döndürür. (Devralındığı yer: Attribute)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Bir ad kümesini karşılık gelen bir dağıtma tanımlayıcısı kümesine eşler. (Devralındığı yer: Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Bir arabirimin tür bilgilerini almak için kullanılabilecek bir nesnenin tür bilgilerini alır. (Devralındığı yer: Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Bir nesnenin sağladığı tür bilgisi arabirimlerinin sayısını alır (0 ya da 1). (Devralındığı yer: Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bir nesne tarafından kullanıma sunulan özelliklere ve yöntemlere erişim sağlar. (Devralındığı yer: Attribute)

Ayrıca bkz.

• SoapDocumentMethodAttribute
• SoapRpcMethodAttribute