WebService WebService WebService WebService Class

Определение

Определяет необязательный базовый класс для веб-служб XML, обеспечивающий прямой доступ к общим объектам ASP.NET, таким как состояние приложения или сеанса.Defines the optional base class for XML Web services, which provides direct access to common ASP.NET objects, such as application and session state.

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 свойство, чтобы получить время запроса на сервере.The example below creates an XML Web service, deriving from WebService, in order to use the Context property to obtain the time of the request on the server.

<%@ 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.If you don't need access to the common ASP.NET objects, you can still create an XML Web service without deriving from WebService. Дополнительные объекты ASP.NET может осуществляться через Context.Additional ASP.NET objects can be accessed through Context.

Методы XML-веб-службы, которые имеют OneWay свойству SoapRpcMethodAttribute или SoapDocumentMethodAttribute присвоено true, не имеют доступа к их HttpContext.XML Web service methods that have the OneWay property of either SoapRpcMethodAttribute or SoapDocumentMethodAttribute set to true, do not have access to their HttpContext. Таким образом, доступе к любому из свойств WebService класс, из внутри этого метода XML-веб-службы, возвращаемое null.As such, accessing any of the properties of the WebService class, from within that XML Web service method, return null.

Если вы используете .NET Framework версии 1.0 XML-веб-службе методы, имеющие SoapRpcMethodAttribute или SoapDocumentMethodAttribute атрибут, примененный к их с помощью OneWay свойства набора для true, не имеют доступа к их HttpContext с помощью статические Current свойство.If you are using the .NET Framework version 1.0 XML Web service methods that have either the SoapRpcMethodAttribute or SoapDocumentMethodAttribute attribute applied to them with the OneWay property of set to true, do not have access to their HttpContext using the static Current property. Чтобы получить доступ к HttpContext, являются производными класса, реализующего метод XML-веб-службы из WebService и получить доступ к Context свойство.To access the HttpContext, derive the class implementing the XML Web service method from WebService and access the Context property.

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

WebService() WebService() WebService() WebService()

Инициализирует новый экземпляр класса WebService.Initializes a new instance of the WebService class.

Свойства

Application Application Application Application

Получает объект приложения для текущего HTTP-запроса.Gets the application object for the current HTTP request.

Container Container Container Container

Возвращает контейнер для компонента.Gets the container for the component.

(Inherited from MarshalByValueComponent)
Context Context Context Context

Получает объект ASP.NET HttpContext для текущего запроса, где инкапсулируется весь HTTP-контекст, используемый HTTP-сервером для обработки веб-запросов.Gets the ASP.NET HttpContext for the current request, which encapsulates all HTTP-specific context used by the HTTP server to process Web requests.

DesignMode DesignMode DesignMode DesignMode

Возвращает значение, показывающее, находится ли компонент в настоящий момент в режиме разработки.Gets a value indicating whether the component is currently in design mode.

(Inherited from MarshalByValueComponent)
Events Events Events Events

Возвращает список обработчиков событий, которые прикреплены к этому компоненту.Gets the list of event handlers that are attached to this component.

(Inherited from MarshalByValueComponent)
Server Server Server Server

Получает HttpServerUtility для текущего запроса.Gets the HttpServerUtility for the current request.

Session Session Session Session

Получает экземпляр HttpSessionState для текущего запроса.Gets the HttpSessionState instance for the current request.

Site Site Site Site

Получает или задает узел компонента.Gets or sets the site of the component.

(Inherited from MarshalByValueComponent)
SoapVersion SoapVersion SoapVersion SoapVersion

Получает версию протокола SOAP, используемого для запроса SOAP к веб-службе XML.Gets the version of the SOAP protocol used to make the SOAP request to the XML Web service.

User User User User

Получает объект сервера ASP.NET User.Gets the ASP.NET server User object. Может использоваться для проверки прав пользователя на выполнение запроса.Can be used to authenticate whether a user is authorized to execute the request.

Методы

Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, используемые объектом MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Inherited from MarshalByValueComponent)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом MarshalByValueComponent, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Inherited from MarshalByValueComponent)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Возвращает средство реализации объекта IServiceProvider.Gets the implementer of the IServiceProvider.

(Inherited from MarshalByValueComponent)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку String, содержащую имя компонента Component, если таковое имеется.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

(Inherited from MarshalByValueComponent)

События

Disposed Disposed Disposed Disposed

Добавляет обработчик событий, чтобы прослушивать событие Disposed для компонента.Adds an event handler to listen to the Disposed event on the component.

(Inherited from MarshalByValueComponent)

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