Partilhar via


WebService Classe

Definição

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
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)

Métodos de Extensão

GetKeyedService<T>(IServiceProvider, Object)

Obtém um serviço do tipo T do IServiceProvider.

GetKeyedServices(IServiceProvider, Type, Object)

Obtém uma enumeração de serviços do tipo serviceType do IServiceProvider.

GetKeyedServices<T>(IServiceProvider, Object)

Obtém uma enumeração de serviços do tipo T do IServiceProvider.

GetRequiredKeyedService(IServiceProvider, Type, Object)

Obtém um serviço do tipo serviceType do IServiceProvider.

GetRequiredKeyedService<T>(IServiceProvider, Object)

Obtém um serviço do tipo T do IServiceProvider.

CreateAsyncScope(IServiceProvider)

Cria um novo AsyncServiceScope que pode ser usado para resolver serviços com escopo.

CreateScope(IServiceProvider)

Cria um novo IServiceScope que pode ser usado para resolver serviços com escopo.

GetRequiredService(IServiceProvider, Type)

Obter serviço do tipo serviceType do IServiceProvider.

GetRequiredService<T>(IServiceProvider)

Obter serviço do tipo T do IServiceProvider.

GetService<T>(IServiceProvider)

Obter serviço do tipo T do IServiceProvider.

GetServices(IServiceProvider, Type)

Obtém uma enumeração de serviços do tipo serviceType do IServiceProvider.

GetServices<T>(IServiceProvider)

Obtém uma enumeração de serviços do tipo T do IServiceProvider.

GetFakeLogCollector(IServiceProvider)

Obtém o objeto que coleta registros de log enviados ao agente falso.

GetFakeRedactionCollector(IServiceProvider)

Obtém a instância falsa do coletor de refatoração do contêiner de injeção de dependência.

Aplica-se a