WebMethodAttribute Třída

Definice

Obor názvů:

System.Web.Services

Sestavení:

System.Web.Services.dll

Přidání tohoto atributu do metody v rámci webové služby XML vytvořené pomocí ASP.NET způsobí, že metoda lze volat ze vzdálených webových klientů. Tuto třídu nelze dědit.

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

Dědičnost

Object

Attribute

WebMethodAttribute

Atributy

AttributeUsageAttribute

Příklady

V následujícím příkladu lze metodu GetMachineName vzdáleně volat přes web, protože má WebMethodAttribute. GetUserName nelze volat vzdáleně, protože nemá WebMethodAttribute, i když je 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

Poznámky

Metody v rámci třídy, které mají tuto sadu atributů, se nazývají metody webové služby XML. Metoda a třída musí být veřejné a spuštěné uvnitř webové aplikace ASP.NET.

Konstruktory

WebMethodAttribute()	Inicializuje novou instanci WebMethodAttribute třídy .
WebMethodAttribute(Boolean)	Inicializuje novou instanci WebMethodAttribute třídy .
WebMethodAttribute(Boolean, TransactionOption)	Inicializuje novou instanci WebMethodAttribute třídy .
WebMethodAttribute(Boolean, TransactionOption, Int32)	Inicializuje novou instanci WebMethodAttribute třídy .
WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean)	Inicializuje novou instanci WebMethodAttribute třídy .

Vlastnosti

BufferResponse	Získá nebo nastaví, zda je odpověď na tento požadavek uložena do vyrovnávací paměti.
CacheDuration	Získá nebo nastaví počet sekund, po který by odpověď měla být uložena v mezipaměti.
Description	Popisná zpráva popisující metodu webové služby XML.
EnableSession	Určuje, zda je povolen stav relace pro metodu webové služby XML.
MessageName	Název použitý pro metodu webové služby XML v datech předaných a vrácených metodou webové služby XML.
TransactionOption	Označuje podporu transakcí metody webové služby XML.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu . (Zděděno od Attribute)

Metody

Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání. (Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Načte informace o typu objektu, které lze použít k získání informací o typu pro rozhraní. (Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1). (Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Poskytuje přístup k vlastnostem a metodám vystaveným objektem. (Zděděno od Attribute)

Viz také

• TransactionOption
• WebService