ScriptMethodAttribute Třída
Definice
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ž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
- 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:
-
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í. -
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 . -
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) |