HttpSimpleClientProtocol.BeginInvoke メソッド
XML Web サービスのメソッドの非同期呼び出しを開始します。
Protected Function BeginInvoke( _
ByVal methodName As String, _ ByVal requestUrl As String, _ ByVal parameters() As Object, _ ByVal callback As AsyncCallback, _ ByVal asyncState As Object _) As IAsyncResult
[C#]
protected IAsyncResult BeginInvoke(stringmethodName,stringrequestUrl,object[] parameters,AsyncCallbackcallback,objectasyncState);
[C++]
protected: IAsyncResult* BeginInvoke(String* methodName,String* requestUrl,Object* parameters __gc[],AsyncCallback* callback,Object* asyncState);
[JScript]
protected function BeginInvoke(
methodName : String,requestUrl : String,parameters : Object[],callback : AsyncCallback,asyncState : Object) : IAsyncResult;
パラメータ
- methodName
XML Web サービス メソッドの名前。 - requestUrl
WebRequest を作成するときに使用する URL。 - parameters
XML Web サービス メソッドに渡すパラメータを格納しているオブジェクトの配列。配列内の値の順序は、呼び出し元の派生クラス メソッドに渡されたパラメータの順序に対応しています。 - callback
非同期メソッドの呼び出しが完了したときに呼び出されるデリゲート。 callback が null 参照 (Visual Basic では Nothing) の場合、このデリゲートは呼び出されません。 - asyncState
クライアントから提供された追加情報。
戻り値
XML Web サービス メソッドからの戻り値を取得するために、 EndInvoke に渡すことのできる IAsyncResult 。
例外
例外の種類 | 条件 |
---|---|
Exception | 要求はサーバー コンピュータに到達しましたが、正常に処理されませんでした。 |
解説
methodName パラメータは、 BeginInvoke を呼び出しているメソッドのパラメータおよび戻り値の種類を検索するために使用します。また、メソッドに追加されたカスタム属性を見つけるためにも使用できます。 SoapDocumentMethodAttribute 、 SoapRpcMethodAttribute 、および XmlElementAttribute は、HTTP プロトコルに必要な派生メソッドに関する追加情報を提供します。
asyncState は、 callback に渡され、 BeginInvoke から返される IAsyncResult の中に含まれています。非同期呼び出しのコンテキストからの情報を、 callback の非同期の結果の処理に渡すには、便利です。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
HttpSimpleClientProtocol クラス | HttpSimpleClientProtocol メンバ | System.Web.Services.Protocols 名前空間 | IAsyncResult