GenerateScriptTypeAttribute Classe

Referência

Definição

Namespace:: System.Web.Script.Services

Assembly:: System.Web.Extensions.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Especifica que o tipo de servidor deve ser gerado no objeto de proxy. Essa classe não pode ser herdada.

public ref class GenerateScriptTypeAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method, AllowMultiple=true)]
public sealed class GenerateScriptTypeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method, AllowMultiple=true)>]
type GenerateScriptTypeAttribute = class
    inherit Attribute

Public NotInheritable Class GenerateScriptTypeAttribute
Inherits Attribute

Herança: Object

Attribute
GenerateScriptTypeAttribute

Atributos: AttributeUsageAttribute

Exemplos

O exemplo a seguir mostra como aplicar GenerateScriptTypeAttribute a uma classe de serviço Web e a um método Web. Como resultado, o ColorObject tipo e seu tipo FavoriteColors aninhado são incluídos no objeto proxy.

Comentários

Em sites de ASP.NET habilitados para AJAX, ASP.NET pode gerar automaticamente objetos proxy para métodos de uma classe de serviço Web. Ele faz isso para a maioria dos tipos de nível superior para os parâmetros de entrada e valores retornados de qualquer método Web marcado com ScriptServiceAttribute.

Em outros casos, se você fizer proxy de objetos gerados para tipos de servidor, deverá aplicar GenerateScriptTypeAttribute manualmente. Você pode aplicar GenerateScriptTypeAttribute ao próprio serviço Web ou a qualquer método de serviço Web ou static método de página marcado com WebMethodAttribute.

Em alguns casos, mesmo que o tipo corresponda a um parâmetro de entrada ou valor retornado de um método de serviço Web, o proxy não será gerado automaticamente. Nesse caso, você deve usar o GenerateScriptTypeAttribute atributo para gerar o objeto proxy para o tipo. Isso ocorre para tipos genéricos e matrizes que têm mais de um argumento, como Dictionary<string,<T>>.

Uma ou mais instâncias de GenerateScriptTypeAttribute podem ser aplicadas a uma classe ou método de serviço Web. ASP.NET gerará uma classe proxy ECMAScript (JavaScript) para cada tipo de nível superior referenciado por cada declaração de GenerateScriptTypeAttribute.

Observação

Se você quiser gerar objetos proxy para tipos aninhados, deverá aplicar GenerateScriptTypeAttribute manualmente a cada tipo aninhado. ASP.NET gera proxies somente para tipos de nível superior e não aplica automaticamente o atributo a tipos aninhados.

Para obter mais informações sobre como usar atributos, consulte Atributos.

Construtores

GenerateScriptTypeAttribute(Type)

Inicializa uma nova instância da classe GenerateScriptTypeAttribute para o tipo especificado.

Propriedades

ScriptTypeId	Obtém ou define o identificador de tipo para o marcador de metadados de tipo.
Type	Obtém o tipo que está incluído no objeto de proxy.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface. (Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute)

Aplica-se a

Partilhar via