WebMethodAttribute Klasa

Definicja

Przestrzeń nazw:

System.Web.Services

Zestaw:

System.Web.Services.dll

Dodanie tego atrybutu do metody w usłudze sieci Web XML utworzonej przy użyciu ASP.NET sprawia, że metoda może być wywoływana przez zdalnych klientów sieci Web. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

Attribute

WebMethodAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie metodę GetMachineName można wywołać zdalnie w sieci Web, ponieważ ma wartość WebMethodAttribute. GetUserName nie można wywołać zdalnie, ponieważ nie ma WebMethodAttributeelementu , mimo że jest publicto .

<%@ 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

Uwagi

Metody w klasie, która ma ten zestaw atrybutów, są nazywane metodami usługi sieci Web XML. Metoda i klasa muszą być publiczne i uruchomione w aplikacji internetowej ASP.NET.

Konstruktory

Nazwa	Opis
WebMethodAttribute()	Inicjuje nowe wystąpienie klasy WebMethodAttribute.
WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean)	Inicjuje nowe wystąpienie klasy WebMethodAttribute.
WebMethodAttribute(Boolean, TransactionOption, Int32)	Inicjuje nowe wystąpienie klasy WebMethodAttribute.
WebMethodAttribute(Boolean, TransactionOption)	Inicjuje nowe wystąpienie klasy WebMethodAttribute.
WebMethodAttribute(Boolean)	Inicjuje nowe wystąpienie klasy WebMethodAttribute.

Właściwości

Nazwa	Opis
BufferResponse	Pobiera lub ustawia, czy odpowiedź dla tego żądania jest buforowana.
CacheDuration	Pobiera lub ustawia liczbę sekund, w których powinna być przechowywana odpowiedź w pamięci podręcznej.
Description	Opisowy komunikat opisujący metodę usługi sieci Web XML.
EnableSession	Wskazuje, czy stan sesji jest włączony dla metody usługi sieci Web XML.
MessageName	Nazwa używana dla metody usługi sieci Web XML w danych przekazanych do i zwrócona z metody usługi sieci Web XML.
TransactionOption	Wskazuje obsługę transakcji metody usługi sieci Web XML.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attribute. (Odziedziczone po Attribute)

Metody

Nazwa	Opis
Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca kod skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Po zastąpieniu w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po zastąpieniu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

Nazwa	Opis
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie obiektu, którego można użyć do uzyskania informacji o typie dla interfejsu. (Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Zapewnia dostęp do właściwości i metod uwidocznionych przez obiekt. (Odziedziczone po Attribute)

Zobacz też

• TransactionOption
• WebService