ScriptMethodAttribute Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określa czasownik HTTP używany do wywoływania metody oraz format odpowiedzi. Klasa ta nie może być dziedziczona.
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
- Dziedziczenie
- Atrybuty
Przykłady
W poniższym przykładzie pokazano, jak zastosować ScriptMethodAttribute do GetXmlDocument
metod i EchoStringAndDate
określić czasownik HTTP do użycia i określić format odpowiedzi.
Uwagi
Ten atrybut służy do określania informacji dotyczących metod, które mogą być wywoływane ze skryptu klienta. Atrybut umożliwia określenie czasownika HTTP (GET lub POST) do wywołania metody. Umożliwia również określenie, czy odpowiedź jest sformatowana przy użyciu notacji obiektów JavaScript (JSON) lub XML.
Atrybut ScriptMethodAttribute jest opcjonalny. (Jednak metody, które można wywołać ze skryptu klienta, muszą mieć System.Web.Services.WebMethodAttribute zastosowany atrybut). Jeśli metoda nie jest oznaczona za pomocą metody , metoda zostanie wywołana przy użyciu polecenia HTTP POST, a odpowiedź zostanie serializowana ScriptMethodAttributejako JSON. Nie można zastąpić tego ustawienia ze skryptu.
ScriptMethodAttribute przyjmuje tylko nazwane parametry. Poniżej przedstawiono właściwości ScriptMethodAttribute klasy, która może być używana jako nazwane parametry:
-
Określa, czy metoda zostanie wywołana przy użyciu polecenia HTTP GET. Wartość domyślna to
false
.Ważne
UseHttpGet Ustawienie właściwości
true
na wartość może stanowić zagrożenie bezpieczeństwa dla aplikacji, jeśli pracujesz z poufnymi danymi lub transakcjami. W żądaniach GET komunikat jest kodowany przez przeglądarkę w adresie URL i dlatego jest łatwiejszym celem manipulowania. W przypadku żądań GET i POST należy przestrzegać wytycznych dotyczących zabezpieczeń w celu ochrony poufnych danych. -
Określa, czy odpowiedź będzie serializowana w formacie JSON, czy jako XML. Wartość domyślna to
Json
. Właściwość jest przydatna ResponseFormat do określania kodu XML jako typu zwracanego, gdy metoda zwraca XmlDocument obiekt lub XmlElement . -
Określa, czy wszystkie zwracane typy, w tym typy ciągów, są serializowane jako XML. Wartość XmlSerializeString właściwości jest ignorowana, gdy odpowiedź jest serializowana jako kod JSON.
Aby uzyskać więcej informacji na temat używania atrybutów, zobacz Atrybuty.
Konstruktory
ScriptMethodAttribute() |
Inicjuje nowe wystąpienie klasy ScriptMethodAttribute. |
Właściwości
ResponseFormat |
Pobiera lub ustawia format odpowiedzi metody. |
TypeId |
Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute. (Odziedziczone po Attribute) |
UseHttpGet |
Pobiera lub ustawia wartość wskazującą, czy wywołać metodę przy użyciu metody HTTP GET. |
XmlSerializeString |
Pobiera lub ustawia wartość wskazującą, czy wszystkie typy zwracane są serializowane jako XML, które zawierają typy ciągów. |
Metody
Equals(Object) |
Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute) |
GetHashCode() |
Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
IsDefaultAttribute() |
W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute) |
Match(Object) |
W przypadku zastąpienia w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Jawne implementacje interfejsu
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute) |
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Pobiera informacje o typie obiektu, którego można użyć do pobrania informacji o typie interfejsu. (Odziedziczone po Attribute) |
_Attribute.GetTypeInfoCount(UInt32) |
Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute) |
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute) |