SoapDocumentMethodAttribute.OneWay 属性

定义

命名空间:

System.Web.Services.Protocols

程序集:

System.Web.Services.dll

获取或设置 XML Web services 客户端是否等待 Web 服务器完成对 XML Web services 方法的处理。

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

如果 XML Web services 客户端不等待 Web 服务器完全处理 XML Web services 方法，则为 true。 默认值是 false。

示例

下面的代码示例是一个 XML Web 服务方法，该方法不要求客户端等待 XML Web 服务方法完成。 因此，此示例将 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 Web 服务方法的 OneWay 属性设置为 true时，XML Web 服务客户端不必等待 Web 服务器完成 XML Web 服务方法的处理。 一旦 Web 服务器反序列化 SoapServerMessage，但在调用 XML Web 服务方法之前，服务器就会返回 HTTP 202 状态代码。 HTTP 202 状态代码向客户端指示 Web 服务器已开始处理消息。 因此，XML Web 服务客户端不会收到 Web 服务器已成功处理消息的确认。

单向方法不能具有返回值或任何 out 参数。

如果使用 .NET Framework 版本 1.0 XML Web 服务方法，这些方法应用了 SoapRpcMethodAttribute 或 属性，并将 OneWay 属性设置为 true，则无法使用静态Current属性访问其HttpContextSoapDocumentMethodAttribute。 若要访问 ， HttpContext请从 WebService 派生实现 XML Web 服务方法的类，并访问 Context 属性。

另请参阅

• SoapServerMessage