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 ScriptMethodAttribute Sie auf die Methoden und anwenden können, GetXmlDocument EchoStringAndDate 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 Client Skript aufgerufen werden können. Mithilfe des-Attributs 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 JavaScript Object Notation (JSON) oder XML formatiert wird.

Das ScriptMethodAttribute-Attribut ist optional. (Auf Methoden, die vom Client Skript aufgerufen werden können, muss jedoch das- System.Web.Services.WebMethodAttribute Attribut angewendet werden.) Wenn eine Methode nicht mit markiert ist ScriptMethodAttribute , 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 überschreiben.

ScriptMethodAttribute nimmt nur benannte Parameter an. Im folgenden sind die Eigenschaften der- ScriptMethodAttribute Klasse aufgeführt, 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

UseHttpGetWenn Sie die-Eigenschaft auf festlegen, true können Sie ein Sicherheitsrisiko für Ihre Anwendung darstellen, wenn Sie mit sensiblen 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 die Sicherheitsrichtlinien befolgen, um sensible Daten zu schützen.
ResponseFormat

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

Gibt an, ob alle Rückgabe Typen, einschließlich Zeichen folgen Typen, als XML serialisiert werden. Der Wert der- XmlSerializeString Eigenschaft wird ignoriert, wenn die Antwort als JSON serialisiert wird.

Weitere Informationen zum Verwenden 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