WebService Classe

Definição

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)

Aplica-se a