WebService Class

Definition

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.Defines the optional base class for XML Web services, which provides direct access to common ASP.NET objects, such as application and session state.

public ref class WebService : System::ComponentModel::MarshalByValueComponent
public class WebService : System.ComponentModel.MarshalByValueComponent
type WebService = class
    inherit MarshalByValueComponent
Public Class WebService
Inherits MarshalByValueComponent
Inheritance
Derived

Examples

Nell'esempio seguente viene creato un servizio Web XML, derivante da WebService, per utilizzare la Context proprietà per ottenere l'ora della richiesta sul server.The example below creates an XML Web service, deriving from WebService, in order to use the Context property to obtain the time of the request on the 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

Remarks

Se non è necessario accedere agli oggetti ASP.NET comuni, è comunque possibile creare un servizio Web XML senza derivare da WebService.If you don't need access to the common ASP.NET objects, you can still create an XML Web service without deriving from WebService. È possibile accedere a oggetti ASP.NET aggiuntivi Contexttramite.Additional ASP.NET objects can be accessed through Context.

OneWay I metodi SoapDocumentMethodAttribute truedel servizio Web XML che hanno la proprietà di HttpContext oimpostatosu,nonhannoaccessoalrelativo.SoapRpcMethodAttributeXML Web service methods that have the OneWay property of either SoapRpcMethodAttribute or SoapDocumentMethodAttribute set to true, do not have access to their HttpContext. Di conseguenza, l'accesso a una qualsiasi delle proprietà della WebService classe, all'interno del metodo del servizio Web XML, nullrestituisce.As such, accessing any of the properties of the WebService class, from within that XML Web service method, return null.

Se si utilizzano i metodi del servizio Web XML .NET Framework versione 1,0 a cui è applicato SoapRpcMethodAttribute l' SoapDocumentMethodAttribute attributo o con la OneWay proprietà impostata HttpContext su true, non è possibile accedervi utilizzando proprietà Current statica.If you are using the .NET Framework version 1.0 XML Web service methods that have either the SoapRpcMethodAttribute or SoapDocumentMethodAttribute attribute applied to them with the OneWay property of set to true, do not have access to their HttpContext using the static Current property. Per accedere HttpContexta, derivare la classe che implementa il metodo di servizio WebService Web XML da Context e accedere alla proprietà.To access the HttpContext, derive the class implementing the XML Web service method from WebService and access the Context property.

Constructors

WebService()

Inizializza una nuova istanza della classe WebService.Initializes a new instance of the WebService class.

Properties

Application

Ottiene l'oggetto applicazione per la richiesta HTTP corrente.Gets the application object for the current HTTP request.

Container

Ottiene il contenitore del componente.Gets the container for the component.

(Inherited from 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.Gets the ASP.NET HttpContext for the current request, which encapsulates all HTTP-specific context used by the HTTP server to process Web requests.

DesignMode

Ottiene un valore che indica se il componente è in modalità progettazione.Gets a value indicating whether the component is currently in design mode.

(Inherited from MarshalByValueComponent)
Events

Ottiene l'elenco dei gestori eventi allegati a questo componente.Gets the list of event handlers that are attached to this component.

(Inherited from MarshalByValueComponent)
Server

Ottiene l'oggetto HttpServerUtility per la richiesta corrente.Gets the HttpServerUtility for the current request.

Session

Ottiene l'istanza HttpSessionState per la richiesta corrente.Gets the HttpSessionState instance for the current request.

Site

Ottiene o imposta il sito del componente.Gets or sets the site of the component.

(Inherited from MarshalByValueComponent)
SoapVersion

Ottiene la versione del protocollo SOAP utilizzata per effettuare la richiesta SOAP al servizio Web XML.Gets the version of the SOAP protocol used to make the SOAP request to the XML Web service.

User

Ottiene l'oggetto User del server ASP.NET.Gets the ASP.NET server User object. Può essere utilizzato per verificare se un utente è autorizzato a eseguire la richiesta.Can be used to authenticate whether a user is authorized to execute the request.

Methods

Dispose()

Rilascia tutte le risorse utilizzate da MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Inherited from MarshalByValueComponent)
Dispose(Boolean)

Rilascia le risorse non gestite utilizzate dall'oggetto MarshalByValueComponent e facoltativamente le risorse gestite.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Inherited from MarshalByValueComponent)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetService(Type)

Ottiene l'implementatore dell'interfaccia IServiceProvider.Gets the implementer of the IServiceProvider.

(Inherited from MarshalByValueComponent)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Inherited from MarshalByValueComponent)

Events

Disposed

Aggiunge un gestore evento per restare in attesa dell'evento Disposed sul componente.Adds an event handler to listen to the Disposed event on the component.

(Inherited from MarshalByValueComponent)

Applies to