WebService Класс

Определение

Пространство имен:

System.Web.Services

Сборка:

System.Web.Services.dll

Определяет необязательный базовый класс для веб-служб XML, обеспечивающий прямой доступ к общим объектам ASP.NET, таким как состояние приложения или сеанса.

public ref class WebService : System::ComponentModel::MarshalByValueComponent

public class WebService : System.ComponentModel.MarshalByValueComponent

type WebService = class
    inherit MarshalByValueComponent

Public Class WebService
Inherits MarshalByValueComponent

Наследование

Object

MarshalByValueComponent

WebService

Производный

System.Workflow.Activities.WorkflowWebService

Примеры

В приведенном ниже примере создается веб-служба XML, наследуемая от WebService, чтобы использовать Context свойство для получения времени запроса на сервере.

<%@ 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

Комментарии

Если вам не нужен доступ к общим объектам ASP.NET, вы по-прежнему можете создать веб-службу XML, не наследуя от WebService. Дополнительные ASP.NET объекты можно получить через Context.

Методы веб-службы XML, у которых свойство OneWaySoapRpcMethodAttribute имеет значение или SoapDocumentMethodAttribute имеет значение true, не имеют доступа к своим HttpContext. Таким образом, при доступе к любому из WebService свойств класса из этого метода веб-службы XML возвращается null.

Если вы используете методы веб-службы XML платформа .NET Framework версии 1.0, SoapRpcMethodAttribute к которым применен атрибут или SoapDocumentMethodAttribute со OneWay свойством , имеющим значение true, не имеют доступа к ним HttpContext с помощью статического Current свойства. Чтобы получить доступ к HttpContext, наследуйте класс, реализуя метод веб-службы XML, от WebService и получите доступ к свойству Context .

Конструкторы

WebService()

Инициализирует новый экземпляр класса WebService.

Свойства

Application	Получает объект приложения для текущего HTTP-запроса.
Container	Возвращает контейнер для компонента. (Унаследовано от MarshalByValueComponent)
Context	Получает объект ASP.NET HttpContext для текущего запроса, где инкапсулируется весь HTTP-контекст, используемый HTTP-сервером для обработки веб-запросов.
DesignMode	Возвращает значение, показывающее, находится ли компонент в настоящий момент в режиме разработки. (Унаследовано от MarshalByValueComponent)
Events	Возвращает список обработчиков событий, которые прикреплены к этому компоненту. (Унаследовано от MarshalByValueComponent)
Server	Получает HttpServerUtility для текущего запроса.
Session	Получает экземпляр HttpSessionState для текущего запроса.
Site	Возвращает или задает сайт компонента. (Унаследовано от MarshalByValueComponent)
SoapVersion	Получает версию протокола SOAP, используемого для запроса SOAP к веб-службе XML.
User	Получает объект сервера ASP.NET User. Может использоваться для проверки прав пользователя на выполнение запроса.

Методы

Dispose()	Освобождает все ресурсы, занятые модулем MarshalByValueComponent. (Унаследовано от MarshalByValueComponent)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом MarshalByValueComponent, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от MarshalByValueComponent)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetService(Type)	Возвращает средство реализации объекта IServiceProvider. (Унаследовано от MarshalByValueComponent)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от MarshalByValueComponent)

События

Disposed

Добавляет обработчик события для ожидания события Disposed в компоненте. (Унаследовано от MarshalByValueComponent)