ScriptMethodAttribute Classe
Definizione
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 il verbo HTTP usato per richiamare un metodo e il formato della risposta. Questa 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 AttributePublic NotInheritable Class ScriptMethodAttribute
Inherits Attribute- Ereditarietà
- Attributi
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 di risposta.
Commenti
Questo attributo viene usato per specificare 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 è formattata usando JavaScript Object Notation (JSON) o XML.
L'attributo ScriptMethodAttribute è facoltativo. Tuttavia, i metodi che possono essere chiamati dallo script client devono avere l'attributo System.Web.Services.WebMethodAttribute applicato. Se un metodo non è contrassegnato con ScriptMethodAttribute, il metodo verrà chiamato usando 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 usate come parametri denominati:
-
Specifica se il metodo verrà richiamato tramite il comando HTTP GET. Il valore predefinito è
false.Importante
L'impostazione della UseHttpGet proprietà su
truepotrebbe 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 manomissione. Per le richieste GET e POST, è necessario seguire le linee guida di sicurezza per proteggere i dati sensibili. -
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 oggetto o XmlElement . -
Specifica se tutti i tipi restituiti, inclusi i tipi stringa, vengono serializzati come XML. Il valore della XmlSerializeString proprietà viene ignorato quando la risposta viene serializzata come JSON.
Per altre informazioni su come usare gli attributi, vedere Attributi.
Costruttori
| Nome | Descrizione |
|---|---|
| ScriptMethodAttribute() |
Inizializza una nuova istanza della classe ScriptMethodAttribute. |
Proprietà
| Nome | Descrizione |
|---|---|
| ResponseFormat |
Ottiene o imposta il formato della risposta del metodo. |
| TypeId |
Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute. (Ereditato da Attribute) |
| UseHttpGet |
Ottiene o imposta un valore che indica se richiamare il metodo utilizzando HTTP GET. |
| XmlSerializeString |
Ottiene o imposta un valore che indica se tutti i tipi restituiti vengono serializzati come XML, inclusi i tipi stringa. |
Metodi
| Nome | Descrizione |
|---|---|
| Equals(Object) |
Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute) |
| GetHashCode() |
Restituisce il codice hash per questa istanza. (Ereditato da Attribute) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| IsDefaultAttribute() |
Quando sottoposto a 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 è uguale a un oggetto specificato. (Ereditato da Attribute) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| _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 per un oggetto, che può essere utilizzato per ottenere le informazioni sul tipo per 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 alle proprietà e ai metodi esposti da un oggetto . (Ereditato da Attribute) |
