WebService Classe

Référence

Définition

Espace de noms:: System.Web.Services

Assembly:: System.Web.Services.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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érivé 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 SoapDocumentMethodAttribute SoapRpcMethodAttribute 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 dont l’attribut ou est appliqué avec la SoapRpcMethodAttribute OneWay propriété définie sur true, n’avez pas accès à leur HttpContext utilisation à l’aide de la propriété statiqueCurrent.SoapDocumentMethodAttribute 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)

Méthodes d’extension

GetKeyedService<T>(IServiceProvider, Object)	Obtient un service de type `T` à partir de IServiceProvider.
GetKeyedServices(IServiceProvider, Type, Object)	Obtient une énumération des services de type `serviceType` à partir de .IServiceProvider
GetKeyedServices<T>(IServiceProvider, Object)	Obtient une énumération des services de type `T` à partir de .IServiceProvider
GetRequiredKeyedService(IServiceProvider, Type, Object)	Obtient un service de type `serviceType` à partir de IServiceProvider.
GetRequiredKeyedService<T>(IServiceProvider, Object)	Obtient un service de type `T` à partir de IServiceProvider.
CreateAsyncScope(IServiceProvider)	Crée un AsyncServiceScope qui peut être utilisé pour résoudre des services délimités.
CreateScope(IServiceProvider)	Crée un IServiceScope qui peut être utilisé pour résoudre des services délimités.
GetRequiredService(IServiceProvider, Type)	Obtient le service de type `serviceType` à partir du IServiceProvider.
GetRequiredService<T>(IServiceProvider)	Obtient le service de type `T` à partir du IServiceProvider.
GetService<T>(IServiceProvider)	Obtient le service de type `T` à partir du IServiceProvider.
GetServices(IServiceProvider, Type)	Obtient une énumération des services de type `serviceType` à partir du IServiceProvider.
GetServices<T>(IServiceProvider)	Obtient une énumération des services de type `T` à partir du IServiceProvider.
GetFakeLogCollector(IServiceProvider)	Obtient l’objet qui collecte les enregistrements de journal envoyés au faux journal.
GetFakeRedactionCollector(IServiceProvider)	Obtient le faux collecteur de redacteurs instance à partir du conteneur d’injection de dépendances.

S’applique à

Partager via