WebMethodAttribute Osztály

Definíció

Névtér:

System.Web.Services

Szerelvény:

System.Web.Services.dll

Ha ezt az attribútumot hozzáadja egy metódushoz egy ASP.NET használatával létrehozott XML-webszolgáltatásban, a metódus hívhatóvá válik távoli webes ügyfelekről. Ez az osztály nem örökölhető.

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

Öröklődés

Object

Attribute

WebMethodAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példában a metódus GetMachineName távolról hívható meg a weben, mert rendelkezik egy WebMethodAttribute. GetUserName távolról nem hívható meg, mert nem rendelkezik WebMethodAttribute, még akkor sem, ha az 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

Megjegyzések

Az attribútumkészlettel rendelkező osztályon belüli metódusokat XML webszolgáltatás-metódusoknak nevezzük. A metódusnak és az osztálynak nyilvánosnak kell lennie, és egy ASP.NET webalkalmazásban kell futnia.

Konstruktorok

Name	Description
WebMethodAttribute()	Inicializálja a WebMethodAttribute osztály új példányát.
WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean)	Inicializálja a WebMethodAttribute osztály új példányát.
WebMethodAttribute(Boolean, TransactionOption, Int32)	Inicializálja a WebMethodAttribute osztály új példányát.
WebMethodAttribute(Boolean, TransactionOption)	Inicializálja a WebMethodAttribute osztály új példányát.
WebMethodAttribute(Boolean)	Inicializálja a WebMethodAttribute osztály új példányát.

Tulajdonságok

Name	Description
BufferResponse	Lekérdezi vagy beállítja, hogy a kérés válasza pufferelve van-e.
CacheDuration	Lekéri vagy beállítja, hogy hány másodpercig kell a választ a gyorsítótárban tartani.
Description	Az XML webszolgáltatás metódusát leíró leíró üzenet.
EnableSession	Azt jelzi, hogy engedélyezve van-e a munkamenet állapota egy XML-webszolgáltatás-metódushoz.
MessageName	Az XML Web service metódushoz használt név az XML-webszolgáltatás-metódusnak átadott és visszaadott adatokban.
TransactionOption	Egy XML-webszolgáltatás-metódus tranzakciós támogatását jelzi.
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Névkészletet képez le a küldési azonosítók megfelelő készletére. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Lekéri egy objektum típusadatait, amelyek a felület típusadatainak lekérésére használhatók. (Öröklődés forrása Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Lekéri az objektumok által biztosított típusinformációs felületek számát (0 vagy 1). (Öröklődés forrása Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Hozzáférést biztosít az objektumok által közzétett tulajdonságokhoz és metódusokhoz. (Öröklődés forrása Attribute)

Lásd még

• TransactionOption
• WebService