SoapHttpClientProtocol.BeginInvoke Метод

Определение

Пространство имен:: System.Web.Services.Protocols

Сборка:: System.Web.Services.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Запускает асинхронное вызов метода веб-службы XML с помощью SOAP.

protected:
 IAsyncResult ^ BeginInvoke(System::String ^ methodName, cli::array <System::Object ^> ^ parameters, AsyncCallback ^ callback, System::Object ^ asyncState);

protected IAsyncResult BeginInvoke(string methodName, object[] parameters, AsyncCallback callback, object asyncState);

member this.BeginInvoke : string * obj[] * AsyncCallback * obj -> IAsyncResult

Protected Function BeginInvoke (methodName As String, parameters As Object(), callback As AsyncCallback, asyncState As Object) As IAsyncResult

Параметры

methodName: String

Имя метода веб-службы XML в производном классе, вызываемом методом BeginInvoke(String, Object[], AsyncCallback, Object) .

parameters: Object[]

Массив объектов, содержащих параметры, передаваемые веб-службе XML. Порядок значений в массиве соответствует порядку параметров в вызывающем методе производного класса.

callback: AsyncCallback

Делегат, вызывающий при завершении асинхронного вызова. В противном случае callbacknullделегат не вызывается.

asyncState: Object

Дополнительные сведения, предоставленные вызывающим абонентом.

Возвращаемое значение

IAsyncResult

Объект IAsyncResult , передаваемый EndInvoke(IAsyncResult) методу для получения возвращаемых значений из вызова удаленного метода.

Исключения

SoapException

Запрос достиг компьютера сервера, но не был успешно обработан.

InvalidOperationException

Запрос недействителен для текущего состояния объекта.

WebException

Произошла ошибка при доступе к сети.

Примеры

Следующий пример кода — это прокси-класс, созданный средством языка описания веб-служб (Wsdl.exe) для Math веб-службы XML. В методе BeginAdd прокси-класса BeginInvoke метод запускает асинхронное вызов к методу Add веб-службы XML.

#using <System.Web.Services.dll>
#using <System.Xml.dll>
#using <System.dll>

using namespace System::Diagnostics;
using namespace System::Xml::Serialization;
using namespace System;
using namespace System::Web::Services::Protocols;
using namespace System::Web::Services;

namespace MyMath
{

   [System::Web::Services::WebServiceBindingAttribute(Name="MyMathSoap",Namespace="http://www.contoso.com/")]
   public ref class MyMath: public System::Web::Services::Protocols::SoapHttpClientProtocol
   {
   public:

      [System::Diagnostics::DebuggerStepThroughAttribute]
      MyMath()
      {
         this->Url = "http://www.contoso.com/math.asmx";
      }


      [System::Diagnostics::DebuggerStepThroughAttribute]
      [System::Web::Services::Protocols::SoapDocumentMethodAttribute("http://www.contoso.com/Add",
      RequestNamespace="http://www.contoso.com/",ResponseNamespace="http://www.contoso.com/",
      Use=System::Web::Services::Description::SoapBindingUse::Literal,
      ParameterStyle=System::Web::Services::Protocols::SoapParameterStyle::Wrapped)]
      int Add( int num1, int num2 )
      {
         array<Object^>^temp1 = {num1,num2};
         array<Object^>^results = this->Invoke( "Add", temp1 );
         return  *dynamic_cast<int^>(results[ 0 ]);
      }


      [System::Diagnostics::DebuggerStepThroughAttribute]
      System::IAsyncResult^ BeginAdd( int num1, int num2, System::AsyncCallback^ callback, Object^ asyncState )
      {
         array<Object^>^temp2 = {num1,num2};
         return this->BeginInvoke( "Add", temp2, callback, asyncState );
      }


      [System::Diagnostics::DebuggerStepThroughAttribute]
      int EndAdd( System::IAsyncResult^ asyncResult )
      {
         array<Object^>^results = this->EndInvoke( asyncResult );
         return  *dynamic_cast<int^>(results[ 0 ]);
      }

   };

}


namespace MyMath {
    using System.Diagnostics;
    using System.Xml.Serialization;
    using System;
    using System.Web.Services.Protocols;
    using System.Web.Services;

    [System.Web.Services.WebServiceBindingAttribute(Name="MyMathSoap", Namespace="http://www.contoso.com/")]
    public class MyMath : System.Web.Services.Protocols.SoapHttpClientProtocol {

        [System.Diagnostics.DebuggerStepThroughAttribute()]
        public MyMath() {
            this.Url = "http://www.contoso.com/math.asmx";
        }

        [System.Diagnostics.DebuggerStepThroughAttribute()]
        [System.Web.Services.Protocols.SoapDocumentMethodAttribute("http://www.contoso.com/Add", RequestNamespace="http://www.contoso.com/", ResponseNamespace="http://www.contoso.com/", Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)]
        public int Add(int num1, int num2) {
            object[] results = this.Invoke("Add", new object[] {num1,
                        num2});
            return ((int)(results[0]));
        }

        [System.Diagnostics.DebuggerStepThroughAttribute()]
        public System.IAsyncResult BeginAdd(int num1, int num2, System.AsyncCallback callback, object asyncState) {
            return this.BeginInvoke("Add", new object[] {num1,
                        num2}, callback, asyncState);
        }

        [System.Diagnostics.DebuggerStepThroughAttribute()]
        public int EndAdd(System.IAsyncResult asyncResult) {
            object[] results = this.EndInvoke(asyncResult);
            return ((int)(results[0]));
        }
    }
}

Option Strict On
Option Explicit On

Imports System.Diagnostics
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Xml.Serialization

Namespace MyMath
    
    <System.Web.Services.WebServiceBindingAttribute(Name:="MyMathSoap", [Namespace]:="http://www.contoso.com/")>  _
    Public Class MyMath
        Inherits System.Web.Services.Protocols.SoapHttpClientProtocol
        
        <System.Diagnostics.DebuggerStepThroughAttribute()>  _
        Public Sub New()
            MyBase.New
            Me.Url = "http://www.contoso.com/math.asmx"
        End Sub
        
        <System.Diagnostics.DebuggerStepThroughAttribute(),  _
         System.Web.Services.Protocols.SoapDocumentMethodAttribute("http://www.contoso.com/Add", RequestNamespace:="http://www.contoso.com/", ResponseNamespace:="http://www.contoso.com/", Use:=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle:=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)>  _
        Public Function Add(ByVal num1 As Integer, ByVal num2 As Integer) As Integer
            Dim results() As Object = Me.Invoke("Add", New Object() {num1, num2})
            Return CType(results(0),Integer)
        End Function
        
        <System.Diagnostics.DebuggerStepThroughAttribute()>  _
        Public Function BeginAdd(ByVal num1 As Integer, ByVal num2 As Integer, ByVal callback As System.AsyncCallback, ByVal asyncState As Object) As System.IAsyncResult
            Return Me.BeginInvoke("Add", New Object() {num1, num2}, callback, asyncState)
        End Function
        
        <System.Diagnostics.DebuggerStepThroughAttribute()>  _
        Public Function EndAdd(ByVal asyncResult As System.IAsyncResult) As Integer
            Dim results() As Object = Me.EndInvoke(asyncResult)
            Return CType(results(0),Integer)
        End Function
    End Class
End Namespace

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

<%@ WebService Language="C#" Class="MyMath"%>
 using System.Web.Services;
 using System;
 
 [WebService(Namespace="http://www.contoso.com/")] 
 public class MyMath {

    [ WebMethod ]
    public int Add(int num1, int num2) {
        return num1+num2;
    }
 }

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

<WebService(Namespace:="http://www.contoso.com/")> _
Public Class MyMath
    <WebMethod()> _
    Public Function Add(num1 As Integer, num2 As Integer) As Integer
        Return num1 + num2
    End Function 'Add
End Class 'Math

Прокси-класс, созданный средством языка описания веб-служб (Wsdl.exe) из описания службы, предоставляет методы веб-службы XML в качестве имен, производных от прокси-класса, для синхронного вызова методов веб-службы XML. Для асинхронного вызова методов веб-службы XML два дополнительных метода добавляются в прокси-класс для каждого метода веб-службы XML, один с Begin префиксом, добавленным в имя метода веб-службы XML, и один с End добавленным префиксом.

Прокси-класс вызывает BeginInvoke метод для запуска асинхронного вызова метода веб-службы XML. Например, если веб-служба XML предоставляет метод веб-службы XML с именем, прокси-класс содержит метод с именемAddBeginAdd, чтобы запустить вызов к методу веб-службы XML. В коде для BeginAddметода выполняется BeginInvoke вызов, и результаты помещаются в ожидаемый тип возвращаемого значения.Add

Используется methodName для поиска настраиваемых атрибутов, которые, возможно, были добавлены в метод, например SoapDocumentMethodAttribute. SoapDocumentMethodAttribute предоставляет дополнительные сведения о производных методах, необходимых для протокола SOAP.

asyncState передается callback в метод и включается в IAsyncResult BeginInvoke него. Параметр asyncState можно использовать для передачи сведений о контексте асинхронного вызова, указанного в параметре callback , делегату, обрабатывающего результат.

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

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

Обратная связь

Были ли сведения на этой странице полезными?