SoapRpcMethodAttribute.OneWay Свойство

Определение

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

System.Web.Services.Protocols

Сборка:

System.Web.Services.dll

Возвращает или задает, ожидает ли клиент веб-службы XML, пока веб-сервер завершит обработку метода веб-службы XML.

public:
 property bool OneWay { bool get(); void set(bool value); };

public bool OneWay { get; set; }

member this.OneWay : bool with get, set

Public Property OneWay As Boolean

Значение свойства

Boolean

true Значение , если клиент веб-службы XML не ожидает полного обработки метода веб-службы XML; falseв противном случае . Значение по умолчанию — false.

Примеры

Следующий пример кода задает OneWay для trueсвойства значение .

<%@ WebService Language="C#" Class="Stats" %>
 
 using System.Web.Services;
 using System.Web.Services.Protocols;
 
 public class Stats: WebService {
 
      [ SoapRpcMethod(OneWay=true) ]
      [ WebMethod(Description="Starts nightly stats batch process.") ]
      public void StartStatsCrunch() {
         // Begin a process that takes a long time to complete.
      }      
 
 }

<%@ WebService Language="VB" Class="Stats" %>
 
Imports System.Web.Services
Imports System.Web.Services.Protocols

Public Class Stats
    Inherits WebService
        
    <SoapRpcMethod(OneWay := True), _
    WebMethod(Description := "Starts nightly stats batch process.")> _
    Public Sub _
        StartStatsCrunch()
        ' Begin a process that takes a long time to complete.
    End Sub
End Class

Комментарии

Если для метода веб-службы XML задано OneWaytrueсвойство, клиент веб-службы XML не должен ожидать завершения обработки метода веб-службы XML. Как только веб-сервер десериализировал SoapServerMessageметод веб-службы, но перед вызовом метода веб-службы XML сервер возвращает код состояния HTTP 202. Код состояния HTTP 202 указывает клиенту, что веб-сервер начал обрабатывать сообщение. Поэтому клиент веб-службы XML не получает подтверждения того, что веб-сервер успешно обработал сообщение.

Односторонние методы не могут иметь возвращаемое значение или какие-либо out параметры.

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