ScriptMethodAttribute 類別

  • 參考

定義

命名空間:
System.Web.Script.Services
組件:
System.Web.Extensions.dll

指定要用來叫用方法的 HTTP 動詞命令 (Verb)，以及回應的格式。 此類別無法獲得繼承。

public ref class ScriptMethodAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class ScriptMethodAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Method)>]
type ScriptMethodAttribute = class
    inherit Attribute
Public NotInheritable Class ScriptMethodAttribute
Inherits Attribute
繼承
Object
Attribute
ScriptMethodAttribute
屬性
AttributeUsageAttribute

範例

下列範例示範如何套用 ScriptMethodAttribute 至 GetXmlDocument 和 EchoStringAndDate 方法，以指定要使用哪個 HTTP 動詞命令，以及指定要指定回應格式。

備註

這個屬性可用來指定可從用戶端腳本呼叫的方法資訊。 屬性可讓您指定哪些 HTTP 動詞命令 (GET 或 POST) 可用來叫用方法。 它也可讓您指定是否使用 JavaScript 物件標記法 (JSON) 或 XML 來格式化回應。

ScriptMethodAttribute 屬性是選擇性的。 不過 (，可以從用戶端腳本呼叫的方法必須套 System.Web.Services.WebMethodAttribute 用 屬性。) 。 如果方法未標示 ScriptMethodAttribute 為 ，則會使用 HTTP POST 命令呼叫 方法，並將回應序列化為 JSON。 您無法從腳本覆寫此設定。

ScriptMethodAttribute 只接受具名參數。 以下是類別的屬性 ScriptMethodAttribute ，可用來做為具名參數：

  • UseHttpGet

    指定是否要使用 HTTP GET 命令叫用 方法。 預設為 false。

    重要

    UseHttpGet如果您使用敏感性資料或交易，將 屬性設定為 true 可能會造成應用程式的安全性風險。 在 GET 要求中，訊息會由瀏覽器編碼為 URL，因此是更容易竄改的目標。 針對 GET 和 POST 要求，您應該遵循安全性指導方針來保護敏感性資料。

  • ResponseFormat

    指定將回應序列化為 JSON 或 XML。 預設為 Json。 屬性 ResponseFormat 在方法傳回 或 XmlElement 物件時，將 XML 指定為傳回 XmlDocument 型別很有用。

  • XmlSerializeString

    指定所有傳回型別，包括字串類型是否序列化為 XML。 當回應序列化為 JSON 時，會忽略 屬性的值 XmlSerializeString 。

如需如何使用屬性的詳細資訊，請參閱 屬性。

建構函式

ScriptMethodAttribute()

初始化 ScriptMethodAttribute 類別的新執行個體。

屬性

ResponseFormat

取得或設定方法回應的格式。
TypeId

在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。

(繼承來源 Attribute)
UseHttpGet

取得或設定值，指出是否使用 HTTP GET 叫用方法。
XmlSerializeString

取得或設定值，指出是否將所有傳回型別 (包含字串型別) 序列化為 XML。

方法

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)

適用於

另請參閱