WebService Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define a classe base opcional para serviços Web XML, que fornece acesso direto a objetos do ASP.NET comuns, como estado de sessão e de aplicativo.
public ref class WebService : System::ComponentModel::MarshalByValueComponentpublic class WebService : System.ComponentModel.MarshalByValueComponenttype WebService = class
inherit MarshalByValueComponentPublic Class WebService
Inherits MarshalByValueComponent- Herança
- Derivado
Exemplos
O exemplo a seguir cria um serviço Web XML, derivado de WebService, para usar a Context propriedade para obter o tempo da solicitação 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
Comentários
Se você não precisar de acesso aos objetos ASP.NET comuns, ainda poderá criar um serviço Web XML sem derivar de WebService. Objetos de ASP.NET adicionais podem ser acessados por meio Contextde .
Os métodos de serviço Web XML que têm a OneWay propriedade de SoapRpcMethodAttribute ou SoapDocumentMethodAttribute definida truecomo , não têm acesso ao seu HttpContext. Dessa forma, acessar qualquer uma das propriedades da WebService classe , de dentro desse método de serviço Web XML, retornará null.
Se você estiver usando o .NET Framework métodos de serviço Web XML versão 1.0 que têm o SoapRpcMethodAttribute atributo ou SoapDocumentMethodAttribute aplicado a eles com a OneWay propriedade de definida truecomo , não tenha acesso a eles HttpContext usando a propriedade estática Current . Para acessar o HttpContext, derive a classe que implementa o método de serviço Web XML de WebService e acesse a Context propriedade .
Construtores
| WebService() |
Inicializa uma nova instância da classe WebService. |
Propriedades
| Application |
Obtém o objeto do aplicativo para a solicitação HTTP atual. |
| Container |
Obtém o contêiner para o componente. (Herdado de MarshalByValueComponent) |
| Context |
Obtém o ASP.NET HttpContext para a solicitação atual, que encapsula todo o contexto específico de HTTP usado pelo servidor HTTP para processar solicitações da Web. |
| DesignMode |
Obtém um valor que indica se o componente está atualmente no modo de design. (Herdado de MarshalByValueComponent) |
| Events |
Obtém a lista de manipuladores de eventos que estão anexados a este componente. (Herdado de MarshalByValueComponent) |
| Server |
Obtém o HttpServerUtility da solicitação atual. |
| Session |
Obtém a instância HttpSessionState para a solicitação atual. |
| Site |
Obtém ou define o site do componente. (Herdado de MarshalByValueComponent) |
| SoapVersion |
Obtém a versão do protocolo SOAP usada para criar a solicitação SOAP para o serviço Web XML. |
| User |
Obtém o objeto User do servidor ASP.NET. Pode ser usado para autenticar se um usuário está autorizado a executar a solicitação. |
Métodos
| Dispose() |
Libera todos os recursos usados pelo MarshalByValueComponent. (Herdado de MarshalByValueComponent) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo MarshalByValueComponent e opcionalmente libera os recursos gerenciados. (Herdado de MarshalByValueComponent) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão. (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 Object atual. (Herdado de Object) |
| ToString() |
Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de MarshalByValueComponent) |
Eventos
| Disposed |
Adiciona um manipulador de eventos para escutar o evento Disposed no componente. (Herdado de MarshalByValueComponent) |
