WebService Classe

Definizione

Spazio dei nomi:

System.Web.Services

Assembly:

System.Web.Services.dll

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à

Object

MarshalByValueComponent

WebService

Derivato

System.Workflow.Activities.WorkflowWebService

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 tramite 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)

Metodi di estensione

GetKeyedService<T>(IServiceProvider, Object)	Ottiene un servizio di tipo T dall'oggetto IServiceProvider.
GetKeyedServices(IServiceProvider, Type, Object)	Ottiene un'enumerazione dei servizi di tipo serviceType dall'oggetto IServiceProvider.
GetKeyedServices<T>(IServiceProvider, Object)	Ottiene un'enumerazione dei servizi di tipo T dall'oggetto IServiceProvider.
GetRequiredKeyedService(IServiceProvider, Type, Object)	Ottiene un servizio di tipo serviceType dall'oggetto IServiceProvider.
GetRequiredKeyedService<T>(IServiceProvider, Object)	Ottiene un servizio di tipo T dall'oggetto IServiceProvider.
CreateAsyncScope(IServiceProvider)	Crea un nuovo oggetto AsyncServiceScope che è possibile usare per risolvere i servizi con ambito.
CreateScope(IServiceProvider)	Crea un nuovo oggetto IServiceScope che è possibile usare per risolvere i servizi con ambito.
GetRequiredService(IServiceProvider, Type)	Ottiene il servizio di tipo serviceType da IServiceProvider.
GetRequiredService<T>(IServiceProvider)	Ottiene il servizio di tipo T da IServiceProvider.
GetService<T>(IServiceProvider)	Ottiene il servizio di tipo T da IServiceProvider.
GetServices(IServiceProvider, Type)	Ottiene un'enumerazione di servizi di tipo serviceType da IServiceProvider.
GetServices<T>(IServiceProvider)	Ottiene un'enumerazione di servizi di tipo T da IServiceProvider.
GetFakeLogCollector(IServiceProvider)	Ottiene l'oggetto che raccoglie i record di log inviati al logger falso.
GetFakeRedactionCollector(IServiceProvider)	Ottiene l'istanza dell'agente di raccolta redactor falso dal contenitore di inserimento delle dipendenze.