ScriptMethodAttribute Třída

Definice

Určuje, který příkaz HTTP se použije k vyvolání metody, a formát odpovědi. Tato třída se nemůže dědit.

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
Dědičnost
ScriptMethodAttribute
Atributy

Příklady

Následující příklad ukazuje, jak použít ScriptMethodAttributeGetXmlDocument metody a EchoStringAndDate k určení, který příkaz HTTP se má použít, a určit formát odpovědi.

Poznámky

Tento atribut slouží k určení informací pro metody, které lze volat z klientského skriptu. Atribut umožňuje určit, které příkazy HTTP (GET nebo POST) lze použít k vyvolání metody. Umožňuje také určit, jestli je odpověď naformátovaná pomocí javascriptové notace JSON (Object Notation) nebo XML.

Atribut ScriptMethodAttribute je volitelný. (Metody, které lze volat z klientského System.Web.Services.WebMethodAttribute skriptu, však musí mít použitý atribut .) Pokud metoda není označena ScriptMethodAttributepomocí , bude metoda volána pomocí příkazu HTTP POST a odpověď bude serializována jako JSON. Toto nastavení nelze přepsat ze skriptu.

ScriptMethodAttribute přijímá pouze pojmenované parametry. Následující jsou vlastnosti ScriptMethodAttribute třídy, které lze použít jako pojmenované parametry:

  • UseHttpGet

    Určuje, jestli bude metoda vyvolána pomocí příkazu HTTP GET. Výchozí formát je false.

    Důležité

    UseHttpGet Nastavení vlastnosti na hodnotu true může představovat bezpečnostní riziko pro vaši aplikaci, pokud pracujete s citlivými daty nebo transakcemi. V požadavcích GET je zpráva zakódovaná prohlížečem do adresy URL, a je proto jednodušším cílem pro manipulaci. U požadavků GET i POST byste měli při ochraně citlivých dat postupovat podle pokynů k zabezpečení.

  • ResponseFormat

    Určuje, jestli bude odpověď serializovaná jako JSON nebo XML. Výchozí formát je Json. Vlastnost ResponseFormat je užitečná k zadání XML jako návratového typu, když metoda vrací XmlDocument objekt nebo XmlElement .

  • XmlSerializeString

    Určuje, zda jsou všechny návratové typy, včetně typů řetězců, serializovány jako XML. Hodnota XmlSerializeString vlastnosti se ignoruje, pokud je odpověď serializovaná jako JSON.

Další informace o používání atributů najdete v tématu Atributy.

Konstruktory

ScriptMethodAttribute()

Inicializuje novou instanci ScriptMethodAttribute třídy .

Vlastnosti

ResponseFormat

Získá nebo nastaví formát odpovědi metody.

TypeId

Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu .

(Zděděno od Attribute)
UseHttpGet

Získá nebo nastaví hodnotu, která označuje, zda vyvolat metodu pomocí HTTP GET.

XmlSerializeString

Získá nebo nastaví hodnotu, která označuje, zda všechny návratové typy jsou serializovány jako XML, který zahrnuje typy řetězců.

Metody

Equals(Object)

Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu.

(Zděděno od Attribute)
GetHashCode()

Vrátí hodnotu hash pro tuto instanci.

(Zděděno od Attribute)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
IsDefaultAttribute()

Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu.

(Zděděno od Attribute)
Match(Object)

Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu.

(Zděděno od Attribute)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Explicitní implementace rozhraní

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání.

(Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Načte informace o typu objektu, které lze použít k získání informací o typu pro rozhraní.

(Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1).

(Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Poskytuje přístup k vlastnostem a metodám vystaveným objektem.

(Zděděno od Attribute)

Platí pro

Viz také