SoapHttpClientProtocol.EndInvoke(IAsyncResult) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Véget vet egy XML-webszolgáltatás-metódus aszinkron meghívásának a SOAP használatával.
protected:
cli::array <System::Object ^> ^ EndInvoke(IAsyncResult ^ asyncResult);protected object[] EndInvoke(IAsyncResult asyncResult);member this.EndInvoke : IAsyncResult -> obj[]Protected Function EndInvoke (asyncResult As IAsyncResult) As Object()Paraméterek
- asyncResult
- IAsyncResult
A IAsyncResult metódusból BeginInvoke(String, Object[], AsyncCallback, Object) visszaadott érték.
Válaszok
Objektumtömb, amely a visszaadott értéket és a származtatott osztálymetódus bármely melléktermékét vagy out paraméterét tartalmazza.
Kivételek
asyncResult nem a metódus visszatérési BeginInvoke(String, Object[], AsyncCallback, Object) értéke.
A kérés elérte a kiszolgáló számítógépét, de a feldolgozás nem sikerült.
A kérés érvénytelen volt az objektum aktuális állapotára vonatkozóan.
Hiba történt a hálózat elérése közben.
Példák
Az alábbi példakód egy proxyosztály, amelyet a Wsdl.exe hoz létre az Math XML-webszolgáltatáshoz.
EndAdd A proxyosztály metódusán belül a EndInvoke metódus befejezi az XML Web Service metódushoz való Add aszinkron meghívást.
#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^>^temp0 = {num1,num2};
array<Object^>^results = this->Invoke( "Add", temp0 );
return *dynamic_cast<int^>(results[ 0 ]);
}
[System::Diagnostics::DebuggerStepThroughAttribute]
System::IAsyncResult^ BeginAdd( int num1, int num2, System::AsyncCallback^ callback, Object^ asyncState )
{
array<Object^>^temp1 = {num1,num2};
return this->BeginInvoke( "Add", temp1, 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
A következő példakód az Math XML-webszolgáltatás, amelyből az előző proxyosztály létrejött.
<%@ 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
Megjegyzések
Általában nem hívná meg közvetlenül a EndInvoke metódust, kivéve, ha saját proxyosztályt hoz létre egy XML-webszolgáltatáshoz.
Egy XML-webszolgáltatás Web Services Description Language eszköze (Wsdl.exe) által létrehozott proxyosztály az XML-webszolgáltatás metódusait a proxyosztály neveként teszi elérhetővé az XML-webszolgáltatás-metódusok szinkron meghívásához. Az XML-webszolgáltatás metódusainak aszinkron meghívásához a rendszer két további metódust ad hozzá a proxyosztályhoz minden XML-webszolgáltatás-metódushoz, egyet az Begin XML webszolgáltatás-metódus nevéhez hozzáadott előtaggal, egyet pedig a End hozzáadott előtaggal.
A proxyosztály meghívja a EndInvoke metódust egy aszinkron hívás végrehajtására az XML Web Service metódushoz. Ha például egy XML-webszolgáltatás elérhetővé tesz egy XML-webszolgáltatás-metódust, Adda proxyosztály egy névvel ellátott EndAddmetódust tartalmaz egy XML-webszolgáltatás-metódus aszinkron meghívásának végrehajtásához. A metódushoz tartozó kódon belül a EndAdd rendszer meghívja a EndInvoke metódust, majd az eredményeket a rendszer a várt visszatérési típusba Addhelyezi.
