WebMethodAttribute Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
L'aggiunta di questo attributo a un metodo all'interno di un servizio Web XML creato tramite ASP.NET rende il metodo chiamabile dai client Web remoti. La classe non può essere ereditata.
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
- Ereditarietà
- Attributi
Esempio
Nell'esempio seguente il metodo GetMachineName può essere chiamato in modalità remota attraverso il Web, perché ha un oggetto WebMethodAttribute.
GetUserName non può essere chiamato in modalità remota, perché non dispone di un WebMethodAttributeoggetto , anche se è 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
Commenti
I metodi all'interno di una classe con questo set di attributi sono denominati metodi del servizio Web XML. Il metodo e la classe devono essere pubblici ed eseguiti all'interno di un'applicazione Web ASP.NET.
Costruttori
| Nome | Descrizione |
|---|---|
| WebMethodAttribute() |
Inizializza una nuova istanza della classe WebMethodAttribute. |
| WebMethodAttribute(Boolean, TransactionOption, Int32, Boolean) |
Inizializza una nuova istanza della classe WebMethodAttribute. |
| WebMethodAttribute(Boolean, TransactionOption, Int32) |
Inizializza una nuova istanza della classe WebMethodAttribute. |
| WebMethodAttribute(Boolean, TransactionOption) |
Inizializza una nuova istanza della classe WebMethodAttribute. |
| WebMethodAttribute(Boolean) |
Inizializza una nuova istanza della classe WebMethodAttribute. |
Proprietà
| Nome | Descrizione |
|---|---|
| BufferResponse |
Ottiene o imposta un valore che indica se la risposta per questa richiesta viene memorizzata nel buffer. |
| CacheDuration |
Ottiene o imposta il numero di secondi in cui deve essere contenuta la risposta nella cache. |
| Description |
Messaggio descrittivo che descrive il metodo del servizio Web XML. |
| EnableSession |
Indica se lo stato della sessione è abilitato per un metodo di servizio Web XML. |
| MessageName |
Nome utilizzato per il metodo del servizio Web XML nei dati passati a e restituiti da un metodo di servizio Web XML. |
| TransactionOption |
Indica il supporto delle transazioni di un metodo di servizio Web XML. |
| TypeId |
Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute. (Ereditato da Attribute) |
Metodi
| Nome | Descrizione |
|---|---|
| Equals(Object) |
Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute) |
| GetHashCode() |
Restituisce il codice hash per questa istanza. (Ereditato da Attribute) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| IsDefaultAttribute() |
Quando sottoposto a override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute) |
| Match(Object) |
Quando sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Esegue il mapping di un set di nomi a un set corrispondente di identificatori dispatch. (Ereditato da Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Recupera le informazioni sul tipo per un oggetto, che può essere utilizzato per ottenere le informazioni sul tipo per un'interfaccia. (Ereditato da Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Recupera il numero di interfacce di informazioni sul tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fornisce l'accesso alle proprietà e ai metodi esposti da un oggetto . (Ereditato da Attribute) |