Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

ScriptMethodAttribute-Klasse

 

Veröffentlicht: Oktober 2016

Gibt an, welche HTTP-Verb zum Aufrufen einer Methode und das Format der Antwort verwendet wird. Diese Klasse kann nicht vererbt werden.

Namespace:   System.Web.Script.Services
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

System.Object
  System.Attribute
    System.Web.Script.Services.ScriptMethodAttribute

[AttributeUsageAttribute(AttributeTargets.Method)]
public sealed class ScriptMethodAttribute : Attribute

NameBeschreibung
System_CAPS_pubmethodScriptMethodAttribute()

Initialisiert eine neue Instanz der ScriptMethodAttribute-Klasse.

NameBeschreibung
System_CAPS_pubpropertyResponseFormat

Ruft ab oder legt das Format der Antwort der Methode.

System_CAPS_pubpropertyTypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.(Geerbt von „Attribute“.)

System_CAPS_pubpropertyUseHttpGet

Ruft ab oder legt einen Wert, der angibt, ob für den Methodenaufruf mithilfe von HTTP GET.

System_CAPS_pubpropertyXmlSerializeString

Ruft ab oder legt einen Wert, der angibt, ob alle Rückgabetypen, Typen als XML serialisiert werden, der String-Typen enthält.

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodGetHashCode()

Gibt den Hashcode für diese Instanz zurück.(Geerbt von „Attribute“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodIsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodMatch(Object)

Ruft beim Überschreiben in einer abgeleiteten Klasse gibt einen Wert, der angibt, ob diese Instanz gleich ein angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_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“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_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“.)

Dieses Attribut wird verwendet, um Informationen für Methoden anzugeben, die von Clientskripts aufgerufen werden kann. Das Attribut können Sie angeben, welche HTTP-Verb (GET oder POST) zum Aufrufen einer Methode verwendet werden kann. Außerdem können Sie angeben, ob die Antwort mit JavaScript Objekt Notation (JSON) oder XML formatiert ist.

Das ScriptMethodAttribute-Attribut ist optional. (Methoden, die von Clientskripts aufgerufen werden können benötigen jedoch die System.Web.Services.WebMethodAttribute angewendet.). Wenn eine Methode nicht mit gekennzeichnet ist ScriptMethodAttribute, wird die Methode mit dem HTTP POST-Befehl aufgerufen werden, und die Antwort als JSON serialisiert. Sie können nicht diese Einstellung über Skript überschreiben.

ScriptMethodAttribute akzeptiert nur benannte Parameter. Im folgenden werden die Eigenschaften der ScriptMethodAttribute -Klasse, die als benannte Parameter verwendet werden kann:

  • UseHttpGet

    Gibt an, ob die Methode mit dem HTTP-GET-Befehl aufgerufen wird. Die Standardeinstellung ist false.

    System_CAPS_security Sicherheit Hinweis

    Festlegen der UseHttpGet -Eigenschaft true kann ein Sicherheitsrisiko für Ihre Anwendung darstellen, wenn Sie vertrauliche Daten oder Transaktionen verwenden. In GET-Anforderungen die Nachricht wird vom Browser in der URL codiert und ist daher ein einfacher Ziel Manipulation. Für Get- und POST-Anforderungen sollten Sie Richtlinien zum Schutz sensibler Daten befolgen.

  • ResponseFormat

    Gibt an, ob die Antwort als JSON oder XML serialisiert wird. Die Standardeinstellung ist Json. Der ResponseFormat Eigenschaft XML als Rückgabetyp angeben, wenn die Methode zurückgegeben kann ein XmlDocument oder ein XmlElement Objekt.

  • XmlSerializeString

    Gibt an, ob alle Rückgabetypen, einschließlich der Zeichenfolgentypen, 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 Erweitern von Metadaten mithilfe von Attributen.

Das folgende Beispiel zeigt, wie angewendet ScriptMethodAttribute die GetXmlDocument und EchoStringAndDate Methoden, um das HTTP-Verb zu verwenden und das Format der Antwort anzugeben.

.NET Framework
Verfügbar seit 3.5

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

WebMethodAttribute
System.Web.Script.Services-Namespace
Using Web Services in ASP.NET AJAX
Exposing Web Services to Client Script in ASP.NET AJAX
Calling Web Services from Client Script in ASP.NET AJAX

Zurück zum Anfang
Anzeigen: