ScriptMethodAttribute Třída

Reference

Definice

Obor názvů:: System.Web.Script.Services

Sestavení:: System.Web.Extensions.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Určuje, který příkaz HTTP se používá k vyvolání metody a formátu odpovědi. Tuto třídu nelze zdě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: Object

Attribute
ScriptMethodAttribute

Atributy: AttributeUsageAttribute

Příklady

Následující příklad ukazuje, jak použít ScriptMethodAttribute na GetXmlDocument EchoStringAndDate metody a k určení, které příkazy HTTP použít a určení formátu odpovědi.

Poznámky

Tento atribut slouží k zadání informací pro metody, které lze volat z klientského skriptu. Atribut umožňuje určit, který příkaz HTTP (GET nebo POST) lze použít k vyvolání metody. Také umožňuje určit, zda je odpověď formátována buď pomocí JavaScript Object Notation (JSON) nebo XML.

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

ScriptMethodAttribute přebírá jenom pojmenované parametry. Níže jsou vlastnosti ScriptMethodAttribute třídy, které lze použít jako pojmenované parametry:

UseHttpGet

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

Důležité

Nastavení UseHttpGet vlastnosti na hodnotu true může představovat bezpečnostní riziko pro vaši aplikaci, pokud pracujete s citlivými daty nebo transakcemi. V rámci požadavků GET je zpráva kódována v prohlížeči na adresu URL, a proto je snazší cíli manipulace. V případě požadavků GET a POST byste měli dodržovat pravidla zabezpečení pro ochranu citlivých dat.
ResponseFormat

Určuje, zda bude odpověď serializována jako JSON nebo jako XML. Výchozí formát je Json. ResponseFormatVlastnost je užitečná pro určení XML jako návratový typ, pokud metoda vrátí XmlDocument nebo XmlElement objekt.
XmlSerializeString

Určuje, zda jsou všechny návratové typy, včetně řetězcových typů, serializovány jako XML. Hodnota XmlSerializeString vlastnosti je ignorována, pokud je odpověď serializována jako JSON.

Další informace o použití atributů naleznete v tématu Attributes.

Konstruktory

ScriptMethodAttribute()

Inicializuje novou instanci ScriptMethodAttribute třídy.

Vlastnosti

ResponseFormat	Získá nebo nastaví formát odezvy metody.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)
UseHttpGet	Získává nebo nastavuje hodnotu, která indikuje, jestli se má vyvolat metoda pomocí HTTP GET.
XmlSerializeString	Získává nebo nastavuje hodnotu, která indikuje, jestli jsou všechny návratové typy serializované jako XML, které obsahují 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á aktuální instanci. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou odvozené třídy. (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ří použádnou kopii aktuálního souboru Object. (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 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