Udostępnij za pośrednictwem


ScriptMethodAttribute Klasa

Definicja

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
ScriptMethodAttribute
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:

  • 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ę 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.

  • ResponseFormat

    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 .

  • XmlSerializeString

    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)

Dotyczy

Zobacz też