ScriptMethodAttribute Класс
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает команду HTTP, используемую для вызова метода и форматирования ответа. Этот класс не наследуется.
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
- Наследование
- Атрибуты
В следующем примере показано, как применить ScriptMethodAttribute к GetXmlDocument
методам и EchoStringAndDate
, чтобы указать, какую HTTP-команду следует использовать, и указать формат ответа.
Этот атрибут используется для указания сведений о методах, которые можно вызывать из клиентского скрипта. Атрибут позволяет указать, какую HTTP-команду (GET или POST) можно использовать для вызова метода. Он также позволяет указать, будет ли ответ отформатирован с помощью нотации объектов JavaScript (JSON) или XML.
Атрибут ScriptMethodAttribute является необязательным. (Однако к методам, которые можно вызывать из клиентского скрипта System.Web.Services.WebMethodAttribute , должен применяться атрибут .) Если метод не помечен как ScriptMethodAttribute, метод будет вызван с помощью команды HTTP POST, а ответ будет сериализован в формате JSON. Этот параметр нельзя переопределить из скрипта.
ScriptMethodAttribute принимает только именованные параметры. Ниже приведены свойства ScriptMethodAttribute класса , которые можно использовать в качестве именованных параметров:
-
Указывает, будет ли метод вызываться с помощью команды HTTP GET. Значение по умолчанию —
false
.Важно!
UseHttpGet Если вы работаете с конфиденциальными данными или транзакциями, для свойства
true
может представлять угрозу безопасности для вашего приложения. В запросах GET сообщение закодировано браузером в URL-адрес и поэтому является более простым объектом для незаконного изменения. Для запросов GET и POST следует следовать рекомендациям по безопасности для защиты конфиденциальных данных. -
Указывает, будет ли ответ сериализован как JSON или XML. Значение по умолчанию —
Json
. Свойство ResponseFormat полезно, чтобы указать XML в качестве возвращаемого типа, когда метод возвращает XmlDocument объект или XmlElement . -
Указывает, сериализуются ли все возвращаемые типы, включая строковые типы, в формате XML. Значение XmlSerializeString свойства игнорируется при сериализации ответа в формате JSON.
Дополнительные сведения об использовании атрибутов см. в разделе Атрибуты.
Script |
Инициализирует новый экземпляр класса ScriptMethodAttribute. |
Response |
Возвращает или задает формат ответа метода. |
Type |
В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute) |
Use |
Возвращает или задает значение, позволяющее определить, следует ли вызывать метод с помощью команды HTTP GET. |
Xml |
Возвращает или задает значение, указывающее, будут ли все возвращаемые типы, включая строковые, сериализованы в формат XML. |
Equals(Object) |
Возвращает значение, показывающее, равен ли экземпляр указанному объекту. (Унаследовано от Attribute) |
Get |
Возвращает хэш-код данного экземпляра. (Унаследовано от Attribute) |
Get |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
Is |
При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute) |
Match(Object) |
При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute) |
Memberwise |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
To |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
_Attribute. |
Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute) |
_Attribute. |
Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса. (Унаследовано от Attribute) |
_Attribute. |
Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute) |
_Attribute. |
Предоставляет доступ к открытым свойствам и методам объекта. (Унаследовано от Attribute) |
Продукт | Версии |
---|---|
.NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: