WebMethodAttribute WebMethodAttribute WebMethodAttribute WebMethodAttribute Class

Определение

Добавление этого атрибута к методу в веб-службе XML, созданной с помощью ASP.NET, делает возможным вызов этого метода для удаленных веб-клиентов.Adding this attribute to a method within an XML Web service created using ASP.NET makes the method callable from remote Web clients. Этот класс не наследуется.This class cannot be inherited.

public ref class WebMethodAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Method, Inherited=true)]
[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class WebMethodAttribute : Attribute
type WebMethodAttribute = class
    inherit Attribute
Public NotInheritable Class WebMethodAttribute
Inherits Attribute
Наследование
WebMethodAttributeWebMethodAttributeWebMethodAttributeWebMethodAttribute
Атрибуты

Примеры

В приведенном ниже примере метод GetMachineName может быть удаленно вызван через Интернет, так как он WebMethodAttributeимеет.In the example below the method GetMachineName can be remotely called across the Web, because it has a WebMethodAttribute. GetUserNameне может быть вызван удаленно, так как у него WebMethodAttributeнет, даже если он publicимеет значение.GetUserName cannot be called remotely, because it does not have a WebMethodAttribute, even though it is 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.Methods within a class that have this attribute set are called XML Web service methods. Метод и класс должны быть общедоступными и выполняться в веб-приложении ASP.NET.The method and class must be public and running inside an ASP.NET Web application.

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

WebMethodAttribute() WebMethodAttribute() WebMethodAttribute() WebMethodAttribute()

Инициализирует новый экземпляр класса WebMethodAttribute.Initializes a new instance of the WebMethodAttribute class.

WebMethodAttribute(Boolean) WebMethodAttribute(Boolean) WebMethodAttribute(Boolean) WebMethodAttribute(Boolean)

Инициализирует новый экземпляр класса WebMethodAttribute.Initializes a new instance of the WebMethodAttribute class.

WebMethodAttribute(Boolean, TransactionOption) WebMethodAttribute(Boolean, TransactionOption) WebMethodAttribute(Boolean, TransactionOption) WebMethodAttribute(Boolean, TransactionOption)

Инициализирует новый экземпляр класса WebMethodAttribute.Initializes a new instance of the WebMethodAttribute class.

WebMethodAttribute(Boolean, TransactionOption) WebMethodAttribute(Boolean, TransactionOption) WebMethodAttribute(Boolean, TransactionOption) WebMethodAttribute(Boolean, TransactionOption)
WebMethodAttribute(Boolean, TransactionOption, Int32) WebMethodAttribute(Boolean, TransactionOption, Int32) WebMethodAttribute(Boolean, TransactionOption, Int32) WebMethodAttribute(Boolean, TransactionOption, Int32)

Инициализирует новый экземпляр класса WebMethodAttribute.Initializes a new instance of the WebMethodAttribute class.

WebMethodAttribute(Boolean, TransactionOption, Int32) WebMethodAttribute(Boolean, TransactionOption, Int32) WebMethodAttribute(Boolean, TransactionOption, Int32) WebMethodAttribute(Boolean, TransactionOption, Int32)
WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean) WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean) WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean) WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean)

Инициализирует новый экземпляр класса WebMethodAttribute.Initializes a new instance of the WebMethodAttribute class.

WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean) WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean) WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean) WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean)

Свойства

BufferResponse BufferResponse BufferResponse BufferResponse

Получает или задает сведения о том, следует ли записывать ответ на этот запрос в буфер.Gets or sets whether the response for this request is buffered.

CacheDuration CacheDuration CacheDuration CacheDuration

Получает или задает число секунд, в течение которого ответ должен храниться в кэше.Gets or sets the number of seconds the response should be held in the cache.

Description Description Description Description

Описательное сообщение для метода веб-службы XML.A descriptive message describing the XML Web service method.

EnableSession EnableSession EnableSession EnableSession

Указывает, включено ли состояние сеанса для метода веб-службы XML.Indicates whether session state is enabled for an XML Web service method.

MessageName MessageName MessageName MessageName

Имя, используемое для метода веб-службы XML в данных, передаваемых в метод веб-службы XML и возвращаемых им.The name used for the XML Web service method in the data passed to and returned from an XML Web service method.

TransactionOption TransactionOption TransactionOption TransactionOption

Обозначает поддержку транзакций для метода веб-службы XML.Indicates the transaction support of an XML Web service method.

TypeId TypeId TypeId TypeId

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Возвращает значение, показывающее, равен ли экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-код данного экземпляра.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Применяется к

Дополнительно