ScriptMethodAttribute Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica qual o verbo HTTP usado para invocar um método e o formato da resposta. Esta classe não pode ser herdada.
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- Herança
- Atributos
Exemplos
O exemplo seguinte mostra como aplicar ScriptMethodAttribute aos GetXmlDocument métodos e EchoStringAndDate para especificar que verbo HTTP usar e para especificar o formato de resposta.
Observações
Este atributo é usado para especificar informação para métodos que podem ser chamados a partir do script cliente. O atributo permite-lhe especificar qual verbo HTTP (GET ou POST) pode ser usado para invocar um método. Também permite especificar se a resposta está formatada usando JavaScript Object Notation (JSON) ou XML.
O ScriptMethodAttribute atributo é opcional. (No entanto, os métodos que podem ser chamados a partir do script cliente devem ter o System.Web.Services.WebMethodAttribute atributo aplicado.) Se um método não estiver marcado com ScriptMethodAttribute, o método será chamado usando o comando HTTP POST e a resposta será serializada como JSON. Não podes sobrescrever esta definição do script.
ScriptMethodAttribute Aceita apenas parâmetros nomeados. As seguintes são as propriedades da ScriptMethodAttribute classe que podem ser usadas como parâmetros nomeados:
-
Especifica se o método será invocado usando o comando HTTP GET. A predefinição é
false.Importante
Definir a UseHttpGet propriedade para
truepode representar um risco de segurança para a sua aplicação se estiver a trabalhar com dados ou transações sensíveis. Nos pedidos GET, a mensagem é codificada pelo navegador na URL e, por isso, é um alvo mais fácil para adulteração. Para pedidos GET e POST, deve seguir as diretrizes de segurança para proteger dados sensíveis. -
Especifica se a resposta será serializada como JSON ou como XML. A predefinição é
Json. A ResponseFormat propriedade é útil para especificar XML como tipo de retorno quando o método retorna um XmlDocument ou um XmlElement objeto. -
Especifica se todos os tipos de retorno, incluindo os tipos de string, são serializados como XML. O valor da XmlSerializeString propriedade é ignorado quando a resposta é serializada como JSON.
Para mais informações sobre como usar os atributos, consulte Atributos.
Construtores
| Name | Description |
|---|---|
| ScriptMethodAttribute() |
Inicializa uma nova instância da ScriptMethodAttribute classe. |
Propriedades
| Name | Description |
|---|---|
| ResponseFormat |
Obtém ou define o formato da resposta do método. |
| TypeId |
Quando implementado numa classe derivada, obtém um identificador único para esta Attribute. (Herdado de Attribute) |
| UseHttpGet |
Recebe ou define um valor que indica se deve invocar o método usando HTTP GET. |
| XmlSerializeString |
Recebe ou define um valor que indica se todos os tipos de retorno são serializados como XML, incluindo os tipos de cadeia. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Devolve um valor que indica se esta instância é igual a um objeto especificado. (Herdado de Attribute) |
| GetHashCode() |
Devolve o código de hash para esta instância. (Herdado de Attribute) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IsDefaultAttribute() |
Quando sobrescrito numa classe derivada, indica se o valor desta instância é o valor padrão para a classe derivada. (Herdado de Attribute) |
| Match(Object) |
Quando sobrescrito numa classe derivada, devolve um valor que indica se esta instância é igual a um objeto especificado. (Herdado de Attribute) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de despacho. (Herdado de Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Recupera a informação de tipo de um objeto, que pode ser usada para obter a informação de tipo para uma interface. (Herdado de Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Recupera o número de interfaces de informações de tipo que um objeto fornece (0 ou 1). (Herdado de Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Proporciona acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute) |