WebService Classe

Definição

Namespace:

System.Web.Services

Assembly:

System.Web.Services.dll

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::MarshalByValueComponent

public class WebService : System.ComponentModel.MarshalByValueComponent

type WebService = class
    inherit MarshalByValueComponent

Public Class WebService
Inherits MarshalByValueComponent

Herança

Object

MarshalByValueComponent

WebService

Derivado

System.Workflow.Activities.WorkflowWebService

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 de Context.

Os métodos de serviço Web XML que têm a OneWay propriedade de SoapRpcMethodAttribute ou SoapDocumentMethodAttribute definido 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 definido como true, não terá acesso a eles HttpContext usando a propriedade estáticaCurrent. 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)