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 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
- Atrybuty
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:
-
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. -
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 . -
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ż
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla