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, имеющие OneWay свойство одного SoapRpcMethodAttribute или SoapDocumentMethodAttribute заданного значения true, не имеют доступа к этим HttpContextметодам. Таким образом, доступ к любому из свойств WebService класса из этого метода веб-службы XML возвращается null.

Если вы используете методы веб-службы XML версии 1.0 .NET Framework, имеющие либо SoapRpcMethodAttributeSoapDocumentMethodAttribute атрибут, примененные к ним со 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	Возвращает объект сервера User ASP.NET. Можно использовать для проверки подлинности, авторизовать ли пользователь для выполнения запроса.

Методы

Имя	Описание
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)