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 zdalnie wywołać 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óre mają ten zestaw atrybutów, są nazywane metodami usługi sieci Web XML. Metoda i klasa muszą być publiczne i uruchomione wewnątrz aplikacji internetowej ASP.NET.

Konstruktory

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

Właściwości

BufferResponse	Pobiera lub ustawia, czy odpowiedź dla tego żądania jest buforowana.
CacheDuration	Pobiera lub ustawia liczbę sekund, przez które powinna być przechowywana odpowiedź w pamięci podręcznej.
Description	Opisowy komunikat opisowy 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óconych 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 Attributeelementu . (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu 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

_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 dla obiektu, który może służyć do pobierania 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)	Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute)

Zobacz też

• TransactionOption
• WebService