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

SoapDocumentMethodAttribute.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.

Примеры

Следующий пример кода — это метод веб-службы XML, который не требует, чтобы клиент ждал завершения метода веб-службы XML. Поэтому пример задает OneWay для свойства значение true.

<%@ WebService Language="C#" Class="Stats" %>
 
 using System.Web.Services;
 using System.Web.Services.Protocols;
 
 public class Stats: WebService {
 
      [ SoapDocumentMethod(OneWay=true) ]
      [ WebMethod(Description="Starts nightly statistics batch process.") ]
      public void StartStatsCrunch() {
         // Begin nightly statistics crunching process.
         // A one-way method cannot have return values.
      }      
 
 }

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

Public Class Stats
    Inherits WebService
        
    <SoapDocumentMethod(OneWay := True), _
    WebMethod(Description := "Starts nightly statistics batch process.")> _
    Public Sub _
        StartStatsCrunch()
        
        ' Begin nightly statistics crunching process.
        ' A one-way method cannot have return values.
    End Sub
End Class

Комментарии

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

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

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

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

См. также раздел