ScriptMethodAttribute Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Megadja, hogy melyik HTTP-parancsot használja a metódus meghívásához, és a válasz formátumát. Ez az osztály nem örökölhető.
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- Öröklődés
- Attribútumok
Példák
Az alábbi példa bemutatja, hogyan alkalmazható azokra ScriptMethodAttribute és GetXmlDocumentEchoStringAndDate metódusokra, amelyekkel megadhatja, hogy melyik HTTP-parancsot használja, és hogyan adja meg a válaszformátumot.
Megjegyzések
Ez az attribútum az ügyfélszkriptből meghívható metódusok információinak megadására szolgál. Az attribútum segítségével megadhatja, hogy melyik HTTP-ige (GET vagy POST) használható metódus meghívására. Azt is megadhatja, hogy a válasz JavaScript Object Notation (JSON) vagy XML használatával van-e formázva.
Az ScriptMethodAttribute attribútum nem kötelező. (Az ügyfélszkriptből meghívható metódusoknak azonban alkalmazniuk kell az System.Web.Services.WebMethodAttribute attribútumot.) Ha egy metódus nincs megjelölve, ScriptMethodAttributea metódus a HTTP POST paranccsal lesz meghívva, és a válasz JSON-ként lesz szerializálva. Ezt a beállítást nem lehet felülírni a szkriptből.
ScriptMethodAttribute csak elnevezett paramétereket vesz fel. Az osztály nevesített paraméterekként használható tulajdonságai a ScriptMethodAttribute következők:
-
Megadja, hogy a metódus a HTTP GET paranccsal legyen-e meghívva. Az alapértelmezett érték a
false.Important
UseHttpGet A tulajdonság
truebeállítása biztonsági kockázatot jelenthet az alkalmazás számára, ha bizalmas adatokkal vagy tranzakciókkal dolgozik. A GET-kérelmekben az üzenetet a böngésző az URL-címre kódolja, ezért könnyebb célpont a módosításhoz. A GET és a POST kérelmek esetében is a bizalmas adatok védelmére vonatkozó biztonsági irányelveket kell követnie. -
Megadja, hogy a válasz szerializálva lesz-e JSON-ként vagy XML-fájlként. Az alapértelmezett érték a
Json. A ResponseFormat tulajdonság akkor hasznos, ha az XML-t adja meg visszatérési típusként, amikor a metódus egy XmlDocument vagy egy objektumot XmlElement ad vissza. -
Megadja, hogy az összes visszatérési típus, beleértve a sztringtípusokat is, XML-ként van-e szerializálva. A tulajdonság értéke XmlSerializeString figyelmen kívül lesz hagyva, amikor a válasz szerializálva lesz JSON-ként.
Az attribútumok használatáról további információt az Attribútumok című témakörben talál.
Konstruktorok
| Name | Description |
|---|---|
| ScriptMethodAttribute() |
Inicializálja a ScriptMethodAttribute osztály új példányát. |
Tulajdonságok
| Name | Description |
|---|---|
| ResponseFormat |
Lekéri vagy beállítja a metódus válaszának formátumát. |
| TypeId |
Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute) |
| UseHttpGet |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a metódust HTTP GET használatával kívánja-e meghívni. |
| XmlSerializeString |
Lekéri vagy beállít egy értéket, amely jelzi, hogy az összes visszatérési típus XML-ként van-e szerializálva, amely sztringtípusokat is tartalmaz. |
Metódusok
| Name | Description |
|---|---|
| Equals(Object) |
Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute) |
| GetHashCode() |
A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| IsDefaultAttribute() |
Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute) |
| Match(Object) |
Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
Explicit interfész-implementációk
| Name | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Névkészletet képez le a küldési azonosítók megfelelő készletére. (Öröklődés forrása Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Lekéri egy objektum típusadatait, amelyek a felület típusadatainak lekérésére használhatók. (Öröklődés forrása Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Lekéri az objektumok által biztosított típusinformációs felületek számát (0 vagy 1). (Öröklődés forrása Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Hozzáférést biztosít az objektumok által közzétett tulajdonságokhoz és metódusokhoz. (Öröklődés forrása Attribute) |
