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 de ASP.NET comunes, todavía puede crear un servicio web XML sin derivar de WebService. Se puede acceder a objetos de 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 aplicado el SoapRpcMethodAttribute atributo o SoapDocumentMethodAttribute con la OneWay propiedad de establecido trueen , no tienen acceso a su HttpContext mediante la propiedad estática Current . Para tener acceso 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)

Métodos de extensión

GetKeyedService<T>(IServiceProvider, Object)	Obtiene un servicio de tipo T de .IServiceProvider
GetKeyedServices(IServiceProvider, Type, Object)	Obtiene una enumeración de servicios de tipo serviceType de .IServiceProvider
GetKeyedServices<T>(IServiceProvider, Object)	Obtiene una enumeración de servicios de tipo T de .IServiceProvider
GetRequiredKeyedService(IServiceProvider, Type, Object)	Obtiene un servicio de tipo serviceType de .IServiceProvider
GetRequiredKeyedService<T>(IServiceProvider, Object)	Obtiene un servicio de tipo T de .IServiceProvider
CreateAsyncScope(IServiceProvider)	Crea una instancia de AsyncServiceScope que se puede usar para resolver los servicios con ámbito.
CreateScope(IServiceProvider)	Crea una instancia de IServiceScope que se puede usar para resolver los servicios con ámbito.
GetRequiredService(IServiceProvider, Type)	Obtiene el servicio de tipo serviceType de IServiceProvider.
GetRequiredService<T>(IServiceProvider)	Obtiene el servicio de tipo T de IServiceProvider.
GetService<T>(IServiceProvider)	Obtiene el servicio de tipo T de IServiceProvider.
GetServices(IServiceProvider, Type)	Obtiene una enumeración de los servicios de tipo serviceType de IServiceProvider.
GetServices<T>(IServiceProvider)	Obtiene una enumeración de los servicios de tipo T de IServiceProvider.
GetFakeLogCollector(IServiceProvider)	Obtiene el objeto que recopila los registros enviados al registrador falso.
GetFakeRedactionCollector(IServiceProvider)	Obtiene la instancia del recopilador de redactores falso del contenedor de inserción de dependencias.