WebMethodAttribute Klasse

Definition

Namespace:

System.Web.Services

Assembly:

System.Web.Services.dll

Durch Hinzufügen dieses Attributs zu einer Methode innerhalb eines mithilfe von ASP.NET erstellten XML-Webdiensts kann die Methode von Remotewebclients aufgerufen werden. Diese Klasse kann nicht vererbt werden.

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

Vererbung

Object

Attribute

WebMethodAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel kann die Methode GetMachineName remote im Web aufgerufen werden, da sie eine WebMethodAttribute. GetUserName kann nicht remote aufgerufen werden, da es nicht über eine WebMethodAttribute, obwohl es ist 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

Hinweise

Methoden innerhalb einer Klasse, die über diesen Attributsatz verfügen, werden als XML-Webdienstmethoden bezeichnet. Die Methode und Klasse muss öffentlich sein und innerhalb einer ASP.NET Webanwendung ausgeführt werden.

Konstruktoren

Name	Beschreibung
WebMethodAttribute()	Initialisiert eine neue Instanz der WebMethodAttribute-Klasse.
WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean)	Initialisiert eine neue Instanz der WebMethodAttribute-Klasse.
WebMethodAttribute(Boolean, TransactionOption, Int32)	Initialisiert eine neue Instanz der WebMethodAttribute-Klasse.
WebMethodAttribute(Boolean, TransactionOption)	Initialisiert eine neue Instanz der WebMethodAttribute-Klasse.
WebMethodAttribute(Boolean)	Initialisiert eine neue Instanz der WebMethodAttribute-Klasse.

Eigenschaften

Name	Beschreibung
BufferResponse	Ruft ab oder legt fest, ob die Antwort für diese Anforderung gepuffert wird.
CacheDuration	Ruft die Anzahl der Sekunden ab, die die Antwort im Cache aufbewahrt werden soll, oder legt sie fest.
Description	Eine beschreibende Meldung, die die XML-Webdienstmethode beschreibt.
EnableSession	Gibt an, ob der Sitzungsstatus für eine XML-Webdienstmethode aktiviert ist.
MessageName	Der Name, der für die XML-Webdienstmethode in den an eine XML-Webdienstmethode übergebenen und von einer XML-Webdienstmethode zurückgegeben wird.
TransactionOption	Gibt die Transaktionsunterstützung einer XML-Webdienstmethode an.
TypeId	Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute)

Methoden

Name	Beschreibung
Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diesen instance zurück. (Geerbt von Attribute)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute)

Weitere Informationen

• TransactionOption
• WebService