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

Применяется к

Поделиться через