WebMethodAttribute Класс

Определение

Пространство имен:

System.Web.Services

Сборка:

System.Web.Services.dll

Добавление этого атрибута в метод в веб-службе XML, созданной с помощью ASP.NET делает метод вызываемым из удаленных веб-клиентов. Этот класс не наследуется.

public ref class WebMethodAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class WebMethodAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method)>]
type WebMethodAttribute = class
    inherit Attribute

Public NotInheritable Class WebMethodAttribute
Inherits Attribute

Наследование

Object

Attribute

WebMethodAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В приведенном ниже примере метод GetMachineName можно удаленно вызывать через Интернет, так как он имеет .WebMethodAttribute GetUserName не может быть вызван удаленно, так как он не имеет WebMethodAttribute, даже если он есть public.

<%@ WebService Language="C#" Class="Util"%>
    using System;
    using System.Web.Services;
    public class Util: WebService {
       public string GetUserName() {
          return User.Identity.Name;
       }
    
       [ WebMethod(Description="Obtains the Server Machine Name",
       EnableSession=true)]
       public string GetMachineName() {
          return Server.MachineName;
       }
    }

<%@ WebService Language="VB" Class="Util"%>

Imports System
Imports System.Web.Services

Public Class Util
    Inherits WebService
    
    Public Function GetUserName() As String
        Return User.Identity.Name
    End Function    
    
    <WebMethod(Description := "Obtains the Server Machine Name", _
        EnableSession := True)> _
    Public Function GetMachineName() As String
        
        Return Server.MachineName
    End Function
End Class

Комментарии

Методы в классе с этим набором атрибутов называются методами веб-службы XML. Метод и класс должны быть общедоступными и запущены в веб-приложении ASP.NET.

Конструкторы

Имя	Описание
WebMethodAttribute()	Инициализирует новый экземпляр класса WebMethodAttribute.
WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean)	Инициализирует новый экземпляр класса WebMethodAttribute.
WebMethodAttribute(Boolean, TransactionOption, Int32)	Инициализирует новый экземпляр класса WebMethodAttribute.
WebMethodAttribute(Boolean, TransactionOption)	Инициализирует новый экземпляр класса WebMethodAttribute.
WebMethodAttribute(Boolean)	Инициализирует новый экземпляр класса WebMethodAttribute.

Свойства

Имя	Описание
BufferResponse	Возвращает или задает, буферичен ли ответ для этого запроса.
CacheDuration	Возвращает или задает количество секунд, которое должен храниться в кэше.
Description	Описательное сообщение, описывающее метод веб-службы XML.
EnableSession	Указывает, включено ли состояние сеанса для метода веб-службы XML.
MessageName	Имя, используемое для метода веб-службы XML в данных, передаваемых и возвращенных из метода веб-службы XML.
TransactionOption	Указывает поддержку транзакций метода веб-службы XML.
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)

См. также раздел

• TransactionOption
• WebService