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žívá k vyvolání metody, a formát 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 AttributePublic NotInheritable Class ScriptMethodAttribute
Inherits Attribute- Dědičnost
- Atributy
Příklady
Následující příklad ukazuje, jak použít ScriptMethodAttribute u GetXmlDocument metod a EchoStringAndDate určit, který příkaz HTTP se má použít a určit formát 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. Umožňuje také určit, jestli je odpověď naformátovaná pomocí javascriptového zápisu objektu (JSON) nebo XML.
Atribut ScriptMethodAttribute je nepovinný. (Metody, které lze volat z klientského System.Web.Services.WebMethodAttribute skriptu, musí mít použitý atribut.) Pokud metoda není označena 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řijímá pouze pojmenované parametry. Níže jsou uvedené vlastnosti ScriptMethodAttribute třídy, které lze použít jako pojmenované parametry:
-
Určuje, zda bude metoda vyvolána pomocí příkazu HTTP GET. Výchozí hodnota je
false.Důležité
UseHttpGet Nastavení vlastnosti
truemůž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 kódována prohlížečem do adresy URL, a proto je jednodušší cíl pro manipulaci. U požadavků GET i POST byste měli postupovat podle pokynů zabezpečení k ochraně citlivých dat. -
Určuje, zda bude odpověď serializována jako JSON nebo JAKO XML. Výchozí hodnota je
Json. Vlastnost ResponseFormat je užitečná k určení XML jako návratového typu, když metoda vrátí XmlDocument nebo XmlElement objekt. -
Určuje, zda jsou všechny návratové typy, včetně typů řetězců, serializovány jako XML. Hodnota XmlSerializeString vlastnosti je ignorována, když je odpověď serializována jako JSON.
Další informace o používání atributů naleznete v tématu Atributy.
Konstruktory
| Name | Description |
|---|---|
| ScriptMethodAttribute() |
Inicializuje novou instanci ScriptMethodAttribute třídy. |
Vlastnosti
| Name | Description |
|---|---|
| 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 tento Attribute. (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 jsou všechny návratové typy serializovány jako XML, což zahrnuje typy řetězců. |
Metody
| Name | Description |
|---|---|
| Equals(Object) |
Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute) |
| GetHashCode() |
Vrátí kód hash pro tuto instanci. (Zděděno od Attribute) |
| GetType() |
Získá Type aktuální instance. (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 pro odvozenou třídu. (Zděděno od Attribute) |
| Match(Object) |
Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního 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í
| Name | Description |
|---|---|
| _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) |
