ScriptMethodAttribute Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.Script.Services

Assembly:: System.Web.Extensions.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Specifica quale verbo HTTP viene utilizzato per richiamare un metodo e il formato della risposta. La classe non può essere ereditata.

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

Ereditarietà: Object

Attribute
ScriptMethodAttribute

Attributi: AttributeUsageAttribute

Esempio

Nell'esempio seguente viene illustrato come applicare ScriptMethodAttribute ai GetXmlDocument metodi e EchoStringAndDate per specificare il verbo HTTP da usare e per specificare il formato della risposta.

Commenti

Questo attributo viene utilizzato per specificare le informazioni per i metodi che possono essere chiamati dallo script client. L'attributo consente di specificare il verbo HTTP (GET o POST) che può essere usato per richiamare un metodo. Consente inoltre di specificare se la risposta viene formattata utilizzando JavaScript Object Notation (JSON) o XML.

L'attributo ScriptMethodAttribute è facoltativo. (Tuttavia, è necessario applicare l'attributo ai metodi che possono essere chiamati dallo script client System.Web.Services.WebMethodAttribute ). Se un metodo non è contrassegnato con ScriptMethodAttribute , il metodo verrà chiamato utilizzando il comando HTTP post e la risposta verrà serializzata come JSON. Non è possibile eseguire l'override di questa impostazione dallo script.

ScriptMethodAttribute accetta solo parametri denominati. Di seguito sono riportate le proprietà della ScriptMethodAttribute classe che possono essere utilizzate come parametri denominati:

UseHttpGet

Specifica se il metodo verrà richiamato utilizzando il comando HTTP GET. Il valore predefinito è false.

Importante

L'impostazione della UseHttpGet proprietà su true può comportare un rischio di sicurezza per l'applicazione se si utilizzano dati o transazioni sensibili. Nelle richieste GET il messaggio viene codificato dal browser nell'URL ed è quindi una destinazione più semplice per la manomissione. Per le richieste GET e POST, è necessario seguire le linee guida di sicurezza per proteggere i dati sensibili.
ResponseFormat

Specifica se la risposta verrà serializzata come JSON o come XML. Il valore predefinito è Json. La ResponseFormat proprietà è utile per specificare XML come tipo restituito quando il metodo restituisce un XmlDocument XmlElement oggetto o.
XmlSerializeString

Specifica se tutti i tipi restituiti, inclusi i tipi di stringa, vengono serializzati come XML. Il valore della XmlSerializeString proprietà viene ignorato quando la risposta viene serializzata come JSON.

Per ulteriori informazioni sull'utilizzo degli attributi, vedere attributi.

Costruttori

ScriptMethodAttribute()

Inizializza una nuova istanza della classe ScriptMethodAttribute.

Proprietà

ResponseFormat	Ottiene o imposta il formato della risposta del metodo.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)
UseHttpGet	Ottiene o imposta un valore che indica se il metodo viene richiamato utilizzando HTTP GET.
XmlSerializeString	Ottiene o imposta un valore che indica se tutti i tipi restituiti, inclusi i tipi stringa, vengono serializzati nel formato XML.

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch. (Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia. (Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornisce l'accesso a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute)

Si applica a