WebService Classe

Définition

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
Dérivé

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 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 dont l’attribut ou est appliqué avec la SoapRpcMethodAttributeOneWay 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 à