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 웹 서비스 메서드입니다. 따라서 샘플에서는 속성을 true.로 OneWay 설정합니다.

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

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

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

추가 정보

• SoapServerMessage