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

trueXML 웹 서비스 클라이언트가 웹 서버가 XML 웹 서비스 메서드를 완전히 처리할 때까지 기다리지 않으면 이고, 그렇지 않으면 . false 기본값은 false입니다.

예제

다음 코드 예제에서는 속성을 .로 true설정합니다OneWay.

<%@ 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 웹 서비스 메서드에 속성이 OneWay 설정된 true경우 XML 웹 서비스 클라이언트는 웹 서버가 XML 웹 서비스 메서드 처리를 완료할 때까지 기다릴 필요가 없습니다. 웹 서버가 역직렬화 SoapServerMessage되는 즉시 XML 웹 서비스 메서드를 호출하기 전에 서버는 HTTP 202 상태 코드를 반환합니다. HTTP 202 상태 코드는 웹 서버가 메시지 처리를 시작했음을 클라이언트에 나타냅니다. 따라서 XML 웹 서비스 클라이언트는 웹 서버가 메시지를 성공적으로 처리했음을 인정하지 않습니다.

단방향 메서드는 반환 값이나 out 매개 변수를 가질 수 없습니다.

속성이 설정된 상태에서 적용 OneWay 된 특성이 SoapDocumentMethodAttribute 있는 SoapRpcMethodAttribute .NET Framework 버전 1.0 XML 웹 서비스 메서드를 true사용하는 경우 정적 Current 속성을 사용하는 메서드 HttpContext 에 대한 액세스를 허용하지 않습니다. 액세스 HttpContext하려면 XML 웹 서비스 메서드를 구현하는 클래스를 파생시키고 속성에 WebService 액세스합니다 Context .