WebService Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет необязательный базовый класс для веб-служб 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
- Наследование
- Производный
Примеры
В приведенном ниже примере создается веб-служба 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) |
Методы расширения
| GetKeyedService<T>(IServiceProvider, Object) |
Возвращает службу типа |
| GetKeyedServices(IServiceProvider, Type, Object) |
Возвращает перечисление служб типа |
| GetKeyedServices<T>(IServiceProvider, Object) |
Возвращает перечисление служб типа |
| GetRequiredKeyedService(IServiceProvider, Type, Object) |
Возвращает службу типа |
| GetRequiredKeyedService<T>(IServiceProvider, Object) |
Возвращает службу типа |
| CreateAsyncScope(IServiceProvider) |
Создает интерфейс AsyncServiceScope, который может использоваться для разрешения служб с ограниченной областью. |
| CreateScope(IServiceProvider) |
Создает интерфейс IServiceScope, который может использоваться для разрешения служб с ограниченной областью. |
| GetRequiredService(IServiceProvider, Type) |
Возвращает службу типа |
| GetRequiredService<T>(IServiceProvider) |
Возвращает службу типа |
| GetService<T>(IServiceProvider) |
Возвращает службу типа |
| GetServices(IServiceProvider, Type) |
Возвращает перечисление служб типа |
| GetServices<T>(IServiceProvider) |
Возвращает перечисление служб типа |
| GetFakeLogCollector(IServiceProvider) |
Возвращает объект , который собирает записи журнала, отправляемые в поддельные средства ведения журнала. |
| GetFakeRedactionCollector(IServiceProvider) |
Возвращает поддельный экземпляр сборщика редактора из контейнера внедрения зависимостей. |