Leggere in inglese

Condividi tramite

WebService Classe

  • Riferimento

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 class WebService : System.ComponentModel.MarshalByValueComponent
Ereditarietà
Object
MarshalByValueComponent
WebService
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();
   }
 }

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.

Si applica a

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1