WebService Classe

Definizione

Definisce la classe di base facoltativa per i servizi Web XML, che fornisce accesso diretto agli oggetti comuni ASP.NET, quali lo stato applicazione e lo stato sessione.

public ref class WebService : System::ComponentModel::MarshalByValueComponent
public class WebService : System.ComponentModel.MarshalByValueComponent
type WebService = class
    inherit MarshalByValueComponent
Public Class WebService
Inherits MarshalByValueComponent
Ereditarietà
Derivato

Esempio

Nell'esempio seguente viene creato un servizio Web XML, derivato da WebService, per utilizzare la Context proprietà per ottenere l'ora della richiesta nel server.

<%@ WebService Language="C#" Class="Util" %>
 
 using System;
 using System.Web.Services;
 
 public class Util: WebService {
   [ WebMethod(Description="Returns the time as stored on the Server",
   EnableSession=false)]
   public string Time() {
      return Context.Timestamp.TimeOfDay.ToString();
   }
 }
<%@ WebService Language="VB" Class="Util" %>
 
Imports System
Imports System.Web.Services

Public Class Util
    Inherits WebService
    
    <WebMethod(Description := "Returns the time as stored on the Server", _
        EnableSession := False)> _
    Public Function Time() As String
        
        Return Context.Timestamp.TimeOfDay.ToString()
    End Function
End Class

Commenti

Se non è necessario accedere agli oggetti ASP.NET comuni, è comunque possibile creare un servizio Web XML senza derivare da WebService. È possibile accedere ad altri oggetti ASP.NET tramite Context.

I metodi del servizio Web XML che hanno la OneWay proprietà di SoapRpcMethodAttribute o SoapDocumentMethodAttribute sono impostati su true, non hanno accesso al relativo HttpContextoggetto . Di conseguenza, l'accesso a una delle proprietà della WebService classe, dall'interno del metodo del servizio Web XML, restituisce null.

Se si usano i metodi del servizio Web XML .NET Framework versione 1.0 che dispongono dell'attributo SoapRpcMethodAttribute o SoapDocumentMethodAttribute applicato a tali metodi con la OneWay proprietà impostata su true, non è possibile accedervi HttpContext usando la proprietà statica Current . Per accedere a HttpContext, derivare la classe che implementa il metodo del servizio Web XML da WebService e accedere alla Context proprietà .

Costruttori

WebService()

Inizializza una nuova istanza della classe WebService.

Proprietà

Application

Ottiene l'oggetto applicazione per la richiesta HTTP corrente.

Container

Ottiene il contenitore del componente.

(Ereditato da MarshalByValueComponent)
Context

Ottiene il HttpContext ASP.NET per la richiesta corrente, che incapsula tutto il contesto HTTP specifico utilizzato dal server HTTP per elaborare le richieste Web.

DesignMode

Ottiene un valore che indica se il componente è in modalità progettazione.

(Ereditato da MarshalByValueComponent)
Events

Ottiene l'elenco dei gestori eventi allegati a questo componente.

(Ereditato da MarshalByValueComponent)
Server

Ottiene l'oggetto HttpServerUtility per la richiesta corrente.

Session

Ottiene l'istanza HttpSessionState per la richiesta corrente.

Site

Ottiene o imposta il sito del componente.

(Ereditato da MarshalByValueComponent)
SoapVersion

Ottiene la versione del protocollo SOAP utilizzata per effettuare la richiesta SOAP al servizio Web XML.

User

Ottiene l'oggetto User del server ASP.NET. Può essere utilizzato per verificare se un utente è autorizzato a eseguire la richiesta.

Metodi

Dispose()

Rilascia tutte le risorse usate da MarshalByValueComponent.

(Ereditato da MarshalByValueComponent)
Dispose(Boolean)

Rilascia le risorse non gestite usate da MarshalByValueComponent e, facoltativamente, le risorse gestite.

(Ereditato da MarshalByValueComponent)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetService(Type)

Ottiene l'implementatore dell'interfaccia IServiceProvider.

(Ereditato da MarshalByValueComponent)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override.

(Ereditato da MarshalByValueComponent)

Eventi

Disposed

Aggiunge un gestore evento per restare in attesa dell'evento Disposed sul componente.

(Ereditato da MarshalByValueComponent)

Si applica a