WebServiceBindingAttribute 類別

定義

命名空間:

System.Web.Services

組件:

System.Web.Services.dll

宣告定義一或多個 XML Web Service 方法的繫結。 此類別無法獲得繼承。

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

繼承

Object

Attribute

WebServiceBindingAttribute

屬性

AttributeUsageAttribute

範例

下列 XML Web 服務會實作來自四個系結的作業。 具體而言，XML Web 服務會宣告它實作作業的三個系結，方法是將三 WebServiceBindingAttribute 個屬性套用至 XML Web 服務。

若要指定 XML Web 服務方法實作作業的系結，會將 套用至每個 XML Web 服務方法， SoapDocumentMethodAttribute 但 除外 DefaultBindingMethod 。 如果未指定 的系結 DefaultBindingMethod ，它會在 XML Web 服務的預設系結上實作作業。

<%@ 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

備註

如 Web 服務描述語言 (WSDL) 所定義的系結類似于介面，其定義一組具體的作業。 每個 XML Web 服務方法都是特定系結內的作業。 XML Web 服務方法是 XML Web 服務的預設系結成員，或套用至實作 XML Web 服務之類別內 WebServiceBindingAttribute 所指定的系結成員。 XML Web 服務可以實作多個系結，方法是將多個 WebServiceBindingAttribute 屬性套用至 XML Web 服務。

一或多個 WebServiceAttribute 屬性套用至 XML Web 服務之後， SoapDocumentMethodAttribute 或 SoapRpcMethodAttribute 可以套用至個別的 XML Web 服務方法，以指出特定 XML Web 服務方法所實作的系結作業。 設定 或 SoapRpcMethodAttribute 的 Binding 屬性 SoapDocumentMethodAttribute ，以指定 XML Web 服務方法正在實作作業的系結。

建構函式

WebServiceBindingAttribute()	初始化 WebServiceBindingAttribute 類別的新執行個體。
WebServiceBindingAttribute(String)	設定 XML Web Service 方法正在實作的繫結的名稱，初始化 WebServiceBindingAttribute 類別的新執行個體。
WebServiceBindingAttribute(String, String)	初始化 WebServiceBindingAttribute 類別的新執行個體。
WebServiceBindingAttribute(String, String, String)	初始化 WebServiceBindingAttribute 類別的新執行個體。

屬性

ConformsTo	取得或設定繫結聲明所遵從的 Web 服務互通性 (WSI) 規格。
EmitConformanceClaims	取得或設定值，指出繫結是否會發出一致性聲明。
Location	取得或設定定義繫結的位置。
Name	取得或設定繫結的名稱。
Namespace	取得或設定與繫結相關的命名空間。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	擷取物件的類型資訊，可以用來取得介面的類型資訊。 (繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	擷取物件提供的類型資訊介面數目 (0 或 1)。 (繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	提供物件所公開的屬性和方法的存取權。 (繼承來源 Attribute)

另請參閱

• SoapDocumentMethodAttribute
• SoapRpcMethodAttribute