WebService Classe

Définition

Espace de noms:

System.Web.Services

Assembly:

System.Web.Services.dll

Définit la classe de base optionnelle pour les services Web XML, fournissant l'accès direct aux objets ASP.NET communs, tels que l'état de l'application et de la session.

public ref class WebService : System::ComponentModel::MarshalByValueComponent

public class WebService : System.ComponentModel.MarshalByValueComponent

type WebService = class
    inherit MarshalByValueComponent

Public Class WebService
Inherits MarshalByValueComponent

Héritage

Object

MarshalByValueComponent

WebService

Dérivé

System.Workflow.Activities.WorkflowWebService

Exemples

L’exemple ci-dessous crée un service Web XML, dérivant de WebService, afin d’utiliser la Context propriété pour obtenir l’heure de la requête sur le serveur.

<%@ 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

Remarques

Si vous n’avez pas besoin d’accéder aux objets ASP.NET courants, vous pouvez toujours créer un service Web XML sans dériver de WebService. Des objets ASP.NET supplémentaires sont accessibles via Context.

Les méthodes de service Web XML qui ont la OneWay propriété ou SoapDocumentMethodAttributeSoapRpcMethodAttribute définie sur true, n’ont pas accès à leur HttpContext. Par conséquent, l’accès à l’une des propriétés de la WebService classe, à partir de cette méthode de service Web XML, retourne null.

Si vous utilisez les méthodes de service Web XML .NET Framework version 1.0 auxquelles l’attribut SoapRpcMethodAttribute ou est SoapDocumentMethodAttribute appliqué avec la OneWay propriété définie sur true, n’avez pas accès à leur HttpContext à l’aide de la propriété statique Current . Pour accéder à , HttpContextdérivez la classe implémentant la méthode de service Web XML à partir de WebService et accédez à la Context propriété .

Constructeurs

WebService()

Initialise une nouvelle instance de la classe WebService.

Propriétés

Application	Obtient l'objet Application de la requête HTTP en cours.
Container	Obtient le conteneur du composant. (Hérité de MarshalByValueComponent)
Context	Obtient HttpContext ASP.NET pour la demande en cours, qui encapsule tout le contexte spécifique à HTTP utilisé par le serveur HTTP pour traiter les demandes Web.
DesignMode	Obtient une valeur indiquant si le composant est actuellement en mode design. (Hérité de MarshalByValueComponent)
Events	Obtient la liste des gestionnaires d'événements attachés à ce composant. (Hérité de MarshalByValueComponent)
Server	Obtient le HttpServerUtility pour la demande en cours.
Session	Obtient l'instance HttpSessionState pour la demande en cours.
Site	Obtient ou définit le site du composant. (Hérité de MarshalByValueComponent)
SoapVersion	Obtient la version du protocole SOAP utilisée pour faire la demande SOAP au service Web XML.
User	Obtient l'objet User du serveur ASP.NET. Peut être utilisé pour déterminer par l'authentification si un utilisateur est autorisé à exécuter la demande.

Méthodes

Dispose()	Libère toutes les ressources utilisées par MarshalByValueComponent. (Hérité de MarshalByValueComponent)
Dispose(Boolean)	Libère les ressources non managées utilisées par MarshalByValueComponent et libère éventuellement les ressources managées. (Hérité de MarshalByValueComponent)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetService(Type)	Obtient l'implémenteur du IServiceProvider. (Hérité de MarshalByValueComponent)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée. (Hérité de MarshalByValueComponent)

Événements

Disposed

Ajoute un gestionnaire d'événements pour écouter l'événement Disposed sur le composant. (Hérité de MarshalByValueComponent)