WebService Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define a classe base opcional para serviços Web XML, que fornece acesso direto a objetos comuns do ASP.NET, como o estado da aplicação e da sessão.
public ref class WebService : System::ComponentModel::MarshalByValueComponent
public class WebService : System.ComponentModel.MarshalByValueComponent
type WebService = class
inherit MarshalByValueComponent
Public Class WebService
Inherits MarshalByValueComponent
- Herança
- Derivado
Exemplos
O exemplo abaixo cria um serviço Web XML, derivado de WebService, para usar a Context propriedade e obter a hora do pedido no 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
Observações
Se não precisar de acesso aos objetos ASP.NET comuns, ainda pode criar um serviço Web XML sem derivar de WebService. Objetos ASP.NET adicionais podem ser acedidos através de Context.
Os métodos de serviço web XML que têm a OneWay propriedade de ou SoapRpcMethodAttributeSoapDocumentMethodAttribute definido como true, não têm acesso ao seu HttpContext. Assim, aceder a qualquer uma das propriedades da WebService classe, a partir desse método de serviço Web XML, retorna null.
Se estiver a usar os métodos de serviço Web XML do .NET Framework versão 1.0 que tenham o atributo SoapRpcMethodAttribute ou SoapDocumentMethodAttribute aplicado com a propriedade OneWay definido para true, não tenha acesso ao seu HttpContext usando a propriedade estática Current. Para aceder ao HttpContext, derive a classe que implementa o método do serviço Web XML a partir de WebService e aceda à Context propriedade.
Construtores
| Name | Description |
|---|---|
| WebService() |
Inicializa uma nova instância da WebService classe. |
Propriedades
| Name | Description |
|---|---|
| Application |
Obtém o objeto de aplicação para o pedido HTTP atual. |
| Container |
Recebe o recipiente do componente. (Herdado de MarshalByValueComponent) |
| Context |
Obtém o ASP.NET HttpContext para o pedido atual, que encapsula todo o contexto específico HTTP usado pelo servidor HTTP para processar pedidos Web. |
| DesignMode |
Recebe um valor que indica se o componente está atualmente em modo de design. (Herdado de MarshalByValueComponent) |
| Events |
Obtém a lista de gestores de eventos que estão associados a este componente. (Herdado de MarshalByValueComponent) |
| Server |
Recebe o HttpServerUtility pedido atual. |
| Session |
Obtém a HttpSessionState instância do pedido atual. |
| Site |
Obtém ou define o local do componente. (Herdado de MarshalByValueComponent) |
| SoapVersion |
Obtém a versão do protocolo SOAP usada para fazer o pedido SOAP ao serviço Web XML. |
| User |
Obtém o ASP.NET servidor User objeto. Pode ser usado para autenticar se um utilizador está autorizado a executar o pedido. |
Métodos
| Name | Description |
|---|---|
| Dispose() |
Liberta todos os recursos utilizados pelo MarshalByValueComponent. (Herdado de MarshalByValueComponent) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pelo MarshalByValueComponent e opcionalmente liberta os recursos geridos. (Herdado de MarshalByValueComponent) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetService(Type) |
Obtém o implementador do IServiceProvider. (Herdado de MarshalByValueComponent) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado. (Herdado de MarshalByValueComponent) |
evento
| Name | Description |
|---|---|
| Disposed |
Adiciona um gestor de eventos para ouvir o Disposed evento no componente. (Herdado de MarshalByValueComponent) |