ScriptMethodAttribute Classe

Definizione

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à
ScriptMethodAttribute
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 quale verbo HTTP (GET o POST) 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. I metodi che possono essere chiamati dallo script client devono tuttavia 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:

  • UseHttpGet

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

    Importante

    Se si utilizzano dati o transazioni sensibili, l'impostazione della UseHttpGet proprietà su true potrebbe rappresentare un rischio per la sicurezza per l'applicazione. 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.

  • 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 oggetto o XmlElement .

  • XmlSerializeString

    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 sull'uso 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

Vedi anche