ScriptMethodAttribute Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.Script.Services
Zestaw:
System.Web.Extensions.dll

Określa czasownik HTTP używany do wywoływania metody i 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
Object
Attribute
ScriptMethodAttribute
Atrybuty
AttributeUsageAttribute

Przykłady

W poniższym przykładzie pokazano, jak zastosować ScriptMethodAttribute metodę GetXmlDocument i EchoStringAndDate w celu określenia czasownika HTTP do użycia i określenia formatu 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, które czasowniki HTTP (GET lub POST) mogą służyć do wywoływania metody. Umożliwia również określenie, czy odpowiedź jest sformatowana przy użyciu formatu JavaScript Object Notation (JSON) lub XML.

Atrybut ScriptMethodAttribute jest opcjonalny. (Jednak metody, które mogą być wywoływane ze skryptu klienta, muszą mieć System.Web.Services.WebMethodAttribute zastosowany atrybut . Jeśli metoda nie zostanie oznaczona ScriptMethodAttributeza pomocą metody , metoda zostanie wywołana przy użyciu polecenia HTTP POST, a odpowiedź zostanie serializowana jako JSON. Tego ustawienia nie można zastąpić za pomocą skryptu.

ScriptMethodAttribute przyjmuje tylko nazwane parametry. Poniżej przedstawiono właściwości ScriptMethodAttribute klasy, które mogą być używane jako nazwane parametry:

  • UseHttpGet

    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ę do adresu URL i dlatego jest łatwiejszym celem manipulowania. W przypadku żądań GET i POST należy przestrzegać wytycznych dotyczących zabezpieczeń, aby chronić poufne dane.

  • ResponseFormat

    Określa, czy odpowiedź będzie serializowana jako 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 .

  • XmlSerializeString

    Określa, czy wszystkie typy zwracane, w tym typy ciągów, są serializowane jako XML. Wartość XmlSerializeString właściwości jest ignorowana, gdy odpowiedź jest serializowana jako 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 Attributeelementu .

(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ść, która wskazuje, czy wszystkie zwracane typy są serializowane jako XML, który zawiera 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 wartość bieżącego wystąpienia.

(Odziedziczone po Object)
IsDefaultAttribute()

Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej.

(Odziedziczone po Attribute)
Match(Object)

Po przesłonięciu 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 dla obiektu, który może służyć do pobierania informacji o typie dla 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)

Dotyczy

Zobacz też