ScriptMethodAttribute Klasse

Referenz

Definition

Namespace:: System.Web.Script.Services

Assembly:: System.Web.Extensions.dll

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 das zum Aufrufen einer Methode verwendete HTTP-Verb sowie das Format der Antwort an. 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 Attribute

Public NotInheritable Class ScriptMethodAttribute
Inherits Attribute

Vererbung: Object

Attribute
ScriptMethodAttribute

Attribute: AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird gezeigt, wie sie auf die GetXmlDocument Methoden und EchoStringAndDate angewendet ScriptMethodAttribute werden, 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 entweder mithilfe von JSON (JavaScript Object Notation) oder XML formatiert wird.

Das ScriptMethodAttribute-Attribut ist optional. (Für Methoden, die vom Clientskript aufgerufen werden können, muss jedoch das System.Web.Services.WebMethodAttribute Attribut angewendet werden.) Wenn eine Methode nicht mit ScriptMethodAttributegekennzeichnet 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 finden Sie die Eigenschaften der ScriptMethodAttribute -Klasse, die als benannte Parameter verwendet werden können:

UseHttpGet

Gibt an, ob die Methode mithilfe des HTTP GET-Befehls aufgerufen wird. Der Standardwert ist false.

Wichtig

Das Festlegen der UseHttpGet Eigenschaft auf true kann ein Sicherheitsrisiko für Ihre Anwendung darstellen, 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. Sowohl für GET- als auch FÜR POST-Anforderungen sollten Sie die Sicherheitsrichtlinien befolgen, um vertrauliche Daten zu schützen.
ResponseFormat

Gibt an, ob die Antwort als JSON oder als XML serialisiert wird. Der Standardwert ist Json. Die ResponseFormat -Eigenschaft ist nützlich, um XML als Rückgabetyp anzugeben, wenn die Methode ein XmlDocument - oder ein XmlElement -Objekt zurückgibt.
XmlSerializeString

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

ScriptMethodAttribute()

Initialisiert eine neue Instanz der ScriptMethodAttribute-Klasse.

Eigenschaften

ResponseFormat	Ruft das Format der Methodenantwort ab oder legt dieses fest.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)
UseHttpGet	Ruft einen Wert ab, der angibt, ob die Methode mit HTTP-GET aufgerufen werden soll, oder legt diesen fest.
XmlSerializeString	Ruft einen Wert ab, der angibt, ob alle Rückgabetypen, einschließlich der Zeichenfolgentypen, als XML serialisiert werden, oder legt diesen fest.

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_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 deren Hilfe 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)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Gilt für:

Teilen über