WebMethodAttribute 類別

定義

命名空間:

System.Web.Services

組件:

System.Web.Services.dll

加入這個屬性 (Attribute) 至使用 ASP.NET 建立的 XML Web Service 內的方法，使該方法可從遠端 Web 用戶端呼叫。 此類別無法獲得繼承。

public ref class WebMethodAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class WebMethodAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method)>]
type WebMethodAttribute = class
    inherit Attribute

Public NotInheritable Class WebMethodAttribute
Inherits Attribute

繼承

Object

Attribute

WebMethodAttribute

屬性

AttributeUsageAttribute

範例

在下列範例中， GetMachineName 方法可以在網路上遠端呼叫，因為它具有 WebMethodAttribute 。 GetUserName 無法從遠端呼叫，因為它沒有 WebMethodAttribute ，即使它是 public 。

<%@ WebService Language="C#" Class="Util"%>
    using System;
    using System.Web.Services;
    public class Util: WebService {
       public string GetUserName() {
          return User.Identity.Name;
       }
    
       [ WebMethod(Description="Obtains the Server Machine Name",
       EnableSession=true)]
       public string GetMachineName() {
          return Server.MachineName;
       }
    }

<%@ WebService Language="VB" Class="Util"%>

Imports System
Imports System.Web.Services

Public Class Util
    Inherits WebService
    
    Public Function GetUserName() As String
        Return User.Identity.Name
    End Function    
    
    <WebMethod(Description := "Obtains the Server Machine Name", _
        EnableSession := True)> _
    Public Function GetMachineName() As String
        
        Return Server.MachineName
    End Function
End Class

備註

具有此屬性集之類別內的方法稱為 XML Web 服務方法。 方法和類別必須是公用的，並在 ASP.NET Web 應用程式內執行。

建構函式

WebMethodAttribute()	初始化 WebMethodAttribute 類別的新執行個體。
WebMethodAttribute(Boolean)	初始化 WebMethodAttribute 類別的新執行個體。
WebMethodAttribute(Boolean, TransactionOption)	初始化 WebMethodAttribute 類別的新執行個體。
WebMethodAttribute(Boolean, TransactionOption, Int32)	初始化 WebMethodAttribute 類別的新執行個體。
WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean)	初始化 WebMethodAttribute 類別的新執行個體。

屬性

BufferResponse	取得或設定這個要求的回應是否緩衝。
CacheDuration	取得或設定回應保留在快取中應有的秒數。
Description	描述訊息，描述 XML Web Service 方法。
EnableSession	指示是否啟用 XML Web Service 方法的工作階段狀態。
MessageName	在 XML Web Service 方法中傳遞並傳回的資料中，XML Web Service 方法所使用的名稱。
TransactionOption	指示 XML Web Service 方法的交易支援。
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)

另請參閱

• TransactionOption
• WebService