GenerateScriptTypeAttribute Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает, что тип сервера должен быть создан в прокси-объекте. Этот класс не наследуется.
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 AttributePublic NotInheritable Class GenerateScriptTypeAttribute
Inherits Attribute- Наследование
- Атрибуты
Примеры
В следующем примере показано, как применяться GenerateScriptTypeAttribute к классу веб-службы и к веб-методу. В результате ColorObject тип и его вложенный тип FavoriteColors включаются в прокси-объект.
Комментарии
В веб-сайтах с поддержкой AJAX ASP.NET ASP.NET может автоматически создавать прокси-объекты для методов класса веб-службы. Это делается для большинства типов верхнего уровня для входных параметров и возвращаемых значений любых веб-методов, помеченных как ScriptServiceAttribute.
В других случаях, если прокси-объекты, созданные для типов серверов, необходимо применить GenerateScriptTypeAttribute вручную. Вы можете применить GenerateScriptTypeAttribute к самому веб-службе или к любому методу веб-службы или static методу страницы, помеченным как WebMethodAttribute.
В некоторых случаях, даже если тип соответствует входным параметру или возвращаемого значения метода веб-службы, прокси-сервер не будет создан автоматически. В этом случае необходимо использовать GenerateScriptTypeAttribute атрибут для создания прокси-объекта для типа. Это происходит для универсальных типов и массивов, имеющих несколько аргументов, например Dictionary<string,<T>>.
Один или несколько экземпляров GenerateScriptTypeAttribute могут применяться к классу или методу веб-службы. ASP.NET затем создаст прокси-класс ECMAScript (JavaScript) для каждого типа верхнего уровня, на который ссылается каждое объявление GenerateScriptTypeAttribute.
Note
Если вы хотите создать прокси-объекты для вложенных типов, необходимо вручную применить GenerateScriptTypeAttribute к каждому вложенного типа. ASP.NET создает прокси-серверы только для типов верхнего уровня и не автоматически рекурсивно применяет атрибут к вложенным типам.
Дополнительные сведения об использовании атрибутов см. в разделе "Атрибуты".
Конструкторы
| Имя | Описание |
|---|---|
| GenerateScriptTypeAttribute(Type) |
Инициализирует новый экземпляр класса для указанного GenerateScriptTypeAttribute типа. |
Свойства
| Имя | Описание |
|---|---|
| ScriptTypeId |
Возвращает или задает идентификатор типа для маркера метаданных типа. |
| Type |
Возвращает тип, включенный в прокси-объект. |
| TypeId |
При реализации в производном классе получает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute) |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute) |
| GetHashCode() |
Возвращает хэш-код для этого экземпляра. (Унаследовано от Attribute) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| IsDefaultAttribute() |
При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute) |
| Match(Object) |
При переопределении в производном классе возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Извлекает сведения о типе объекта, который можно использовать для получения сведений о типе для интерфейса. (Унаследовано от Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Предоставляет доступ к свойствам и методам, предоставляемым объектом. (Унаследовано от Attribute) |
