SoapHttpClientProtocol.BeginInvoke メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SoapHttpClientProtocol.BeginInvoke メソッド

SOAP を使用して XML Web サービスメソッドの非同期呼び出しを開始します。

名前空間: System.Web.Services.Protocols
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim methodName As String
Dim parameters As Object()
Dim callback As AsyncCallback
Dim asyncState As Object
Dim returnValue As IAsyncResult

returnValue = Me.BeginInvoke(methodName, parameters, callback,
 asyncState)

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

C++

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

protected IAsyncResult BeginInvoke (
    String methodName, 
    Object[] parameters, 
    AsyncCallback callback, 
    Object asyncState
)

JScript

protected function BeginInvoke (
    methodName : String, 
    parameters : Object[], 
    callback : AsyncCallback, 
    asyncState : Object
) : IAsyncResult

パラメータ

methodName: BeginInvoke メソッドを呼び出している、派生クラス内の XML Web サービスメソッドの名前。

parameters: XML Web サービスに渡すパラメータを格納しているオブジェクトの配列。配列内の値の順序は、呼び出し元の派生クラスメソッドに渡されたパラメータの順序に対応しています。

callback: 非同期呼び出しが完了したときに呼び出されるデリゲート。callback が null 参照 (Visual Basic では Nothing) の場合、このデリゲートは呼び出されません。

asyncState: 呼び出し元によって提供される補足情報。

戻り値
リモートメソッドの呼び出しからの戻り値を取得するために、EndInvoke メソッドに渡される IAsyncResult。

例外

例外の種類	条件
SoapException	要求はサーバーコンピュータに到達しましたが、正常に処理されませんでした。

解説

XML Web サービス用に独自のプロキシクラスを構築した場合を除き、通常、BeginInvoke メソッドを直接呼び出すことはありません。

サービスの説明から Web サービス記述言語ツール (Wsdl.exe) によって生成されたプロキシクラスは、XML Web サービスメソッドを同期的に呼び出すプロキシクラスから派生する名前で XML Web サービスメソッドを公開します。XML Web サービスメソッドを非同期的に呼び出すには、各 XML Web サービスメソッドのプロキシクラスに 2 つのメソッドが追加されます。XML Web サービスメソッドの名前に Begin プリフィックスが付けられたメソッドと End プリフィックスが付けられたメソッドの 2 つです。

プロキシクラスは、BeginInvoke メソッドを呼び出して、XML Web サービスメソッドへの非同期呼び出しを開始します。たとえば、XML Web サービスが Add という名前の XML Web サービスメソッドを公開する場合、プロキシクラスには、その XML Web サービスメソッドへの呼び出しを開始するための BeginAdd という名前のメソッドが含まれます。BeginAdd のコードの中で、BeginInvoke メソッドが呼び出され、その結果は Add に対する有効な戻り値の型に格納されます。

methodName は、メソッドに追加された可能性がある SoapDocumentMethodAttribute などのカスタム属性を検索するために使用します。SoapDocumentMethodAttribute は、SOAP プロトコルに必要な派生メソッドに関する追加情報を示します。

asyncState は callback に渡され、BeginInvoke メソッドから返される IAsyncResult の中に含まれています。asyncState パラメータを使用して、結果を処理する callback パラメータに指定された、デリゲートへの非同期呼び出しのコンテキストに関する情報を渡すことができます。

使用例

Web サービス記述言語ツール (Wsdl.exe) によって、Math XML Web サービス用に生成されるプロキシクラスのコード例を次に示します。プロキシクラスの BeginAdd メソッドの中で、BeginInvoke メソッドは、Add XML Web サービスメソッドの非同期呼び出しを開始しています。

Visual Basic

Option Strict On
Option Explicit On

Imports System
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

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]));
        }
    }
}

C++

#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 ]);
      }

   };

}

package MyMath; 

import System.Diagnostics.*;
import System.Xml.Serialization.*;
import System.*;
import System.Web.Services.Protocols.*;
import System.Web.Services.*;

/** @attribute System.Web.Services.WebServiceBindingAttribute(Name = 
    "MyMathSoap", Namespace = "http://www.contoso.com/")
 */

public class MyMath extends System.Web.Services.Protocols.SoapHttpClientProtocol
{
    /** @attribute System.Diagnostics.DebuggerStepThroughAttribute()
     */

    public MyMath()
    {
        this.set_Url("http://www.contoso.com/math.asmx");
    } //MyMath

    /** @attribute System.Diagnostics.DebuggerStepThroughAttribute()
     */
    /** @attribute 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[] { 
            (Int32)num1, (Int32)num2 });
        return (int)((Int32)results.get_Item(0));
    } //Add

    /** @attribute System.Diagnostics.DebuggerStepThroughAttribute()
     */

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

    /** @attribute System.Diagnostics.DebuggerStepThroughAttribute()
     */

    public int EndAdd(System.IAsyncResult asyncResult)
    {
        Object results[] = this.EndInvoke(asyncResult);
        return (int)((Int32)results.get_Item(0));
    } //EndAdd
} //MyMath

前述のプロキシクラスの作成元の Math XML Web サービスのコード例を次に示します。

Visual Basic

<%@ 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

<%@ 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="VJ#" Class="MyMath"%>
import System.Web.Services .* ;
import System .* ;


/** @attribute WebService(Namespace = "http://www.contoso.com/")
* */
public class MyMath
{
   /** @attribute WebMethod()
   * */
   public int Add(int num1,
 int num2) 
   {
      return num1 + num2 ;
   } 
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SoapHttpClientProtocol クラス
SoapHttpClientProtocol メンバ
System.Web.Services.Protocols 名前空間
IAsyncResult
AsyncCallback
EndInvoke
SoapDocumentMethodAttribute クラス
WebClientProtocol

>> 「SoapHttpClientProtocol.BeginInvoke メソッド」を含む用語の索引
SoapHttpClientProtocol.BeginInvoke メソッドのページへのリンク

SoapHttpClientProtocol.BeginInvoke メソッドとは？わかりやすく解説

SoapHttpClientProtocol.BeginInvoke メソッド

英和和英テキスト翻訳


	© 2026 Microsoft.All rights reserved.

SoapHttpClientProtocol.BeginInvoke メソッドとは？ わかりやすく解説

SoapHttpClientProtocol.BeginInvoke メソッド

急上昇のことば

英和和英テキスト翻訳

SoapHttpClientProtocol.BeginInvoke メソッドとは？わかりやすく解説