WebService Clase

Definición

Espacio de nombres:

System.Web.Services

Ensamblado:

System.Web.Services.dll

Define la clase base opcional de los servicios Web XML, que proporciona acceso directo a los objetos comunes de ASP.NET, como los de aplicación y estado de sesión.

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

public class WebService : System.ComponentModel.MarshalByValueComponent

type WebService = class
    inherit MarshalByValueComponent

Public Class WebService
Inherits MarshalByValueComponent

Herencia

Object

MarshalByValueComponent

WebService

Derivado

System.Workflow.Activities.WorkflowWebService

Ejemplos

En el ejemplo siguiente se crea un servicio web XML, que deriva de WebService, con el fin de usar la Context propiedad para obtener la hora de la solicitud en el servidor.

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

Comentarios

Si no necesita acceso a los objetos comunes de ASP.NET, todavía puede crear un servicio web XML sin derivar de WebService. Se puede acceder a objetos ASP.NET adicionales a través de Context.

Los métodos de servicio web XML que tienen la OneWay propiedad de SoapRpcMethodAttribute o SoapDocumentMethodAttribute se establecen trueen , no tienen acceso a su HttpContext. Por lo tanto, el acceso a cualquiera de las propiedades de la WebService clase , desde dentro de ese método de servicio web XML, devuelve null.

Si usa los métodos de servicio web XML de .NET Framework versión 1.0 que tienen el SoapRpcMethodAttribute atributo o SoapDocumentMethodAttribute aplicado a ellos con la OneWay propiedad de establecida trueen , no tiene acceso a su HttpContext mediante la propiedad estática Current . Para acceder a HttpContext, derive la clase que implementa el método de servicio web XML desde WebService y acceda a la Context propiedad .

Constructores

WebService()

Inicializa una nueva instancia de la clase WebService.

Propiedades

Application	Obtiene el objeto de aplicación de la solicitud HTTP actual.
Container	Obtiene el contenedor del componente. (Heredado de MarshalByValueComponent)
Context	Obtiene el objeto HttpContext de ASP.NET para la solicitud actual, que encapsula todo el contexto específico de HTTP utilizado por el servidor HTTP para procesar solicitudes Web.
DesignMode	Obtiene un valor que indica si el componente está actualmente en modo de diseño. (Heredado de MarshalByValueComponent)
Events	Obtiene la lista de controladores de eventos asociados a este componente. (Heredado de MarshalByValueComponent)
Server	Obtiene el valor de la clase HttpServerUtility para la solicitud actual.
Session	Obtiene la instancia de HttpSessionState para la solicitud actual.
Site	Obtiene o establece el sitio del componente. (Heredado de MarshalByValueComponent)
SoapVersion	Obtiene la versión del protocolo SOAP utilizada para realizar la solicitud SOAP al servicio Web XML.
User	Obtiene el objeto de servidor ASP.NET User. Puede utilizarse con el fin de autenticar la autorización de un usuario para ejecutar la solicitud.

Métodos

Dispose()	Libera todos los recursos que usa MarshalByValueComponent. (Heredado de MarshalByValueComponent)
Dispose(Boolean)	Libera los recursos no administrados que usa MarshalByValueComponent y, de forma opcional, libera los recursos administrados. (Heredado de MarshalByValueComponent)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetService(Type)	Obtiene el implementador de IServiceProvider. (Heredado de MarshalByValueComponent)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de MarshalByValueComponent)

Eventos

Disposed

Agrega un controlador de eventos para escuchar el evento Disposed sobre el componente. (Heredado de MarshalByValueComponent)