WebMethodAttribute Třída

Definice

Obor názvů:

System.Web.Services

Sestavení:

System.Web.Services.dll

Přidání tohoto atributu do metody ve webové službě XML vytvořené pomocí ASP.NET umožňuje volat metodu ze vzdálených webových klientů. Tato třída se nemůže 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 příkladu pod metodou GetMachineName lze 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

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

Vlastnosti

Name	Description
BufferResponse	Získá nebo nastaví, zda odpověď pro tento požadavek je 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 pro metodu webové služby XML povolen stav relace.
MessageName	Název použitý pro metodu webové služby XML v datech předaných a vrácených z metody 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 tento Attribute. (Zděděno od Attribute)

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí kód hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je 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á určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

Name	Description
_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