ScriptMethodAttribute Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt an, welches HTTP-Verb zum Aufrufen einer Methode und zum Format der Antwort verwendet wird. Diese Klasse kann nicht vererbt werden.
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- Vererbung
- Attribute
Beispiele
Im folgenden Beispiel wird gezeigt, wie Sie auf die GetXmlDocument Und EchoStringAndDate Methoden anwendenScriptMethodAttribute, um anzugeben, welches HTTP-Verb verwendet werden soll, und um das Antwortformat anzugeben.
Hinweise
Dieses Attribut wird verwendet, um Informationen für Methoden anzugeben, die vom Clientskript aufgerufen werden können. Mit dem Attribut können Sie angeben, welches HTTP-Verb (GET oder POST) zum Aufrufen einer Methode verwendet werden kann. Außerdem können Sie angeben, ob die Antwort mithilfe von JavaScript Object Notation (JSON) oder XML formatiert ist.
Das attribut ScriptMethodAttribute ist optional. (Methoden, die vom Clientskript aufgerufen werden können, müssen jedoch das System.Web.Services.WebMethodAttribute Attribut angewendet haben.) Wenn eine Methode nicht mit ScriptMethodAttributemarkiert ist, wird die Methode mithilfe des HTTP POST-Befehls aufgerufen, und die Antwort wird als JSON serialisiert. Sie können diese Einstellung nicht über das Skript außer Kraft setzen.
ScriptMethodAttribute akzeptiert nur benannte Parameter. Im Folgenden sind die Eigenschaften der ScriptMethodAttribute Klasse aufgeführt, die als benannte Parameter verwendet werden können:
-
Gibt an, ob die Methode mithilfe des HTTP GET-Befehls aufgerufen wird. Der Standardwert lautet
false.Von Bedeutung
Wenn Sie die UseHttpGet Eigenschaft so festlegen, dass
truesie ein Sicherheitsrisiko für Ihre Anwendung darstellt, wenn Sie mit vertraulichen Daten oder Transaktionen arbeiten. In GET-Anforderungen wird die Nachricht vom Browser in die URL codiert und ist daher ein einfacheres Ziel für Manipulationen. Für GET- und POST-Anforderungen sollten Sie Sicherheitsrichtlinien befolgen, um vertrauliche Daten zu schützen. -
Gibt an, ob die Antwort als JSON oder ALS XML serialisiert wird. Der Standardwert lautet
Json. Die ResponseFormat Eigenschaft ist nützlich, um XML als Rückgabetyp anzugeben, wenn die Methode ein XmlDocument oder ein XmlElement Objekt zurückgibt. -
Gibt an, ob alle Rückgabetypen, einschließlich Zeichenfolgentypen, als XML serialisiert werden. Der Wert der XmlSerializeString Eigenschaft wird ignoriert, wenn die Antwort als JSON serialisiert wird.
Weitere Informationen zur Verwendung von Attributen finden Sie unter "Attribute".
Konstruktoren
| Name | Beschreibung |
|---|---|
| ScriptMethodAttribute() |
Initialisiert eine neue Instanz der ScriptMethodAttribute-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| ResponseFormat |
Ruft das Format der Methodenantwort ab oder legt dieses fest. |
| TypeId |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute) |
| UseHttpGet |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Methode mithilfe von HTTP GET aufgerufen werden soll. |
| XmlSerializeString |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob alle Rückgabetypen als XML serialisiert werden, die Zeichenfolgentypen enthalten. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute) |
| GetHashCode() |
Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsDefaultAttribute() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute) |
| Match(Object) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute) |
