SoapHttpClientProtocol SoapHttpClientProtocol SoapHttpClientProtocol SoapHttpClientProtocol Class

定義

SOAP 使用時のクライアント プロキシの派生元となるクラスを指定します。Specifies the class client that proxies derive from when using SOAP.

public ref class SoapHttpClientProtocol : System::Web::Services::Protocols::HttpWebClientProtocol
[System.Runtime.InteropServices.ComVisible(true)]
public class SoapHttpClientProtocol : System.Web.Services.Protocols.HttpWebClientProtocol
type SoapHttpClientProtocol = class
    inherit HttpWebClientProtocol
Public Class SoapHttpClientProtocol
Inherits HttpWebClientProtocol
継承
属性

次のコード例は、の Wsdl.exe によって生成されたプロキシ クラス、 Math XML Web サービス。The following code example is a proxy class generated by Wsdl.exe for the Math XML Web service. プロキシ クラスの派生元SoapHttpClientProtocol、抽象から派生したWebClientProtocolクラス。The proxy class derives from SoapHttpClientProtocol, which derives from the abstract WebClientProtocol class.

#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
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 Web サービス。The following code example is the Math XML Web service, from which the preceding proxy class was generated.

重要

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。This example has a text box that accepts user input, which is a potential security threat. 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。By default, ASP.NET Web pages validate that user input does not include script or HTML elements. 詳細については、「スクリプトによる攻略の概要」を参照してください。For more information, see Script Exploits Overview.

注釈

XML Web サービス クライアントを構築する場合、プロキシ クラスから派生した直接または間接的にWebClientProtocolXML Web サービス用に作成する必要があります。If you are building an XML Web service client, then a proxy class that derives indirectly or directly from WebClientProtocol must be created for the XML Web service. XML Web サービス クライアントが SOAP を使用してを呼び出すと、プロキシ クラスがから派生する必要がありますSoapHttpClientProtocolから派生したHttpWebClientProtocolします。When the XML Web service client calls using SOAP, the proxy class must derive from SoapHttpClientProtocol, which derives from HttpWebClientProtocol. HttpWebClientProtocol、から派生、WebClientProtocolします。HttpWebClientProtocol, in turn, derives from WebClientProtocol.

XML Web サービスを通信から直接または間接的に派生するプロキシ クラスを作成WebClientProtocol呼び出そうとする XML Web サービス。To communicate with an XML Web service, create a proxy class that derives indirectly or directly from WebClientProtocol for the XML Web service you want to call. プロキシ クラスを手動で作成する代わりに、Web サービス記述言語ツール (Wsdl.exe) を使用して、指定された XML Web サービスのサービスの説明用のプロキシ クラスを作成します。Instead of creating the proxy class manually, use the Web Services Description Language tool (Wsdl.exe) to create a proxy class for a given XML Web service's service description. を介して、XML Web サービス メソッドへの同期呼び出しが行われる SOAP プロトコルのプロキシ クラスを生成すると、ときに、Invokeメソッドを使用して非同期呼び出しが行われる一方、BeginInvokeメソッドとEndInvokeメソッド。When a proxy class is generated for the SOAP protocol, synchronous calls to XML Web service methods are made via the Invoke method, whereas asynchronous calls are made using the BeginInvoke method and the EndInvoke method.

注意 (継承者)

このクラスをオーバーライドする場合は、XML Web サービスの特定の種類に固有の派生クラスでメソッドを導入できます。When you override this class, you can introduce methods in the derived class which are specific to a particular type of XML Web service. メソッドは、パラメーターをキャプチャし、XML Web サービスとの通信の作業を行う基本クラスを呼び出します。The methods capture the parameters and call the base class to do the work of communicating with the XML Web service. 導入されたメソッドが非同期の場合は、呼び出し、BeginInvoke(String, Object[], AsyncCallback, Object)メソッドとEndInvoke(IAsyncResult)メソッド。If the introduced methods are asynchronous, call the BeginInvoke(String, Object[], AsyncCallback, Object) method and the EndInvoke(IAsyncResult) method. 導入されたメソッドが同期の場合は、呼び出し、Invoke(String, Object[])メソッド。If the introduced methods are synchronous, call the Invoke(String, Object[]) method. 通常、オーバーライドされたコンス トラクターを設定、Urlプロパティを XML Web サービス メソッドの URL。The overridden constructor typically sets the Url property to the URL of the XML Web service method.

コンストラクター

SoapHttpClientProtocol() SoapHttpClientProtocol() SoapHttpClientProtocol() SoapHttpClientProtocol()

SoapHttpClientProtocol クラスの新しいインスタンスを初期化します。Initializes a new instance of the SoapHttpClientProtocol class.

プロパティ

AllowAutoRedirect AllowAutoRedirect AllowAutoRedirect AllowAutoRedirect

クライアントがサーバーのリダイレクトに自動的に従うかどうかを取得または設定します。Gets or sets whether the client automatically follows server redirects.

(Inherited from HttpWebClientProtocol)
CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ClientCertificates ClientCertificates ClientCertificates ClientCertificates

クライアント証明書のコレクションを取得します。Gets the collection of client certificates.

(Inherited from HttpWebClientProtocol)
ConnectionGroupName ConnectionGroupName ConnectionGroupName ConnectionGroupName

要求に対して使用する接続グループの名前を取得または設定します。Gets or sets the name of the connection group for the request.

(Inherited from WebClientProtocol)
Container Container Container Container

IContainer を格納している Component を取得します。Gets the IContainer that contains the Component.

(Inherited from Component)
CookieContainer CookieContainer CookieContainer CookieContainer

クッキーのコレクションを取得または設定します。Gets or sets the collection of cookies.

(Inherited from HttpWebClientProtocol)
Credentials Credentials Credentials Credentials

XML Web サービス クライアント認証のセキュリティ資格情報を取得または設定します。Gets or sets security credentials for XML Web service client authentication.

(Inherited from WebClientProtocol)
DesignMode DesignMode DesignMode DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
EnableDecompression EnableDecompression EnableDecompression EnableDecompression

この HttpWebClientProtocol の圧縮解除が有効かどうかを示す値を取得または設定します。Gets or sets a value that indicates whether decompression is enabled for this HttpWebClientProtocol.

(Inherited from HttpWebClientProtocol)
Events Events Events Events

Component に結び付けられているイベント ハンドラーのリストを取得します。Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
PreAuthenticate PreAuthenticate PreAuthenticate PreAuthenticate

事前認証を有効にするかどうかを取得または設定します。Gets or sets whether pre-authentication is enabled.

(Inherited from WebClientProtocol)
Proxy Proxy Proxy Proxy

ファイアウォールをとおして XML Web サービス要求を行うためのプロキシ情報を取得または設定します。Gets or sets proxy information for making an XML Web service request through a firewall.

(Inherited from HttpWebClientProtocol)
RequestEncoding RequestEncoding RequestEncoding RequestEncoding

クライアントが XML Web サービスを要求するときに使用される EncodingThe Encoding used to make the client request to the XML Web service.

(Inherited from WebClientProtocol)
Site Site Site Site

ComponentISite を取得または設定します。Gets or sets the ISite of the Component.

(Inherited from Component)
SoapVersion SoapVersion SoapVersion SoapVersion

XML Web サービスに対して SOAP 要求を行うために使用する SOAP プロトコルのバージョンを取得または設定します。Gets or sets the version of the SOAP protocol used to make the SOAP request to the XML Web service.

Timeout Timeout Timeout Timeout

同期的な XML Web サービスの要求に対する返答の受信を XML Web サービス クライアントが待機する時間 (ミリ秒単位) を示します。Indicates the time an XML Web service client waits for the reply to a synchronous XML Web service request to arrive (in milliseconds).

(Inherited from WebClientProtocol)
UnsafeAuthenticatedConnectionSharing UnsafeAuthenticatedConnectionSharing UnsafeAuthenticatedConnectionSharing UnsafeAuthenticatedConnectionSharing

XML Web サービスをホストしている Web サービスに接続するときにクライアントが NTLM 認証を使用する場合、接続共有が有効になっているかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether connection sharing is enabled when the client uses NTLM authentication to connect to the Web server that hosts the XML Web service.

(Inherited from HttpWebClientProtocol)
Url Url Url Url

クライアントが要求している XML Web サービスのベース URL を取得または設定します。Gets or sets the base URL of the XML Web service the client is requesting.

(Inherited from WebClientProtocol)
UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials

Credentials プロパティを DefaultCredentials プロパティの値に設定するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether to set the Credentials property to the value of the DefaultCredentials property.

(Inherited from WebClientProtocol)
UserAgent UserAgent UserAgent UserAgent

それぞれの要求と共に送信されるユーザー エージェント ヘッダーの値を取得または設定します。Gets or sets the value for the user agent header that is sent with each request.

(Inherited from HttpWebClientProtocol)

メソッド

Abort() Abort() Abort() Abort()

XML Web サービス メソッドへの要求をキャンセルします。Cancels a request to an XML Web service method.

(Inherited from WebClientProtocol)
BeginInvoke(String, Object[], AsyncCallback, Object) BeginInvoke(String, Object[], AsyncCallback, Object) BeginInvoke(String, Object[], AsyncCallback, Object) BeginInvoke(String, Object[], AsyncCallback, Object)

SOAP を使用して XML Web サービス メソッドの非同期呼び出しを開始します。Starts an asynchronous invocation of an XML Web service method using SOAP.

CancelAsync(Object) CancelAsync(Object) CancelAsync(Object) CancelAsync(Object)

呼び出しが完了済みの場合を除き、XML Web サービス メソッドの非同期呼び出しをキャンセルします。Cancels an asynchronous call to an XML Web service method, unless the call has already completed.

(Inherited from HttpWebClientProtocol)
CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Discover() Discover() Discover() Discover()

Url にある探索ドキュメントに記述されている XML Web サービスに動的にバインドします。Dynamically binds to an XML Web service described in the discovery document at Url.

Dispose() Dispose() Dispose() Dispose()

Component によって使用されているすべてのリソースを解放します。Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Component によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
EndInvoke(IAsyncResult) EndInvoke(IAsyncResult) EndInvoke(IAsyncResult) EndInvoke(IAsyncResult)

SOAP を使用して XML Web サービス メソッドの非同期呼び出しを終了します。Ends an asynchronous invocation of an XML Web service method using SOAP.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetReaderForMessage(SoapClientMessage, Int32) GetReaderForMessage(SoapClientMessage, Int32) GetReaderForMessage(SoapClientMessage, Int32) GetReaderForMessage(SoapClientMessage, Int32)

XmlReader パラメーターの Stream プロパティで初期化された SoapClientMessage を返します。Returns an XmlReader initialized with the Stream property of the SoapClientMessage parameter.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
GetWebRequest(Uri) GetWebRequest(Uri) GetWebRequest(Uri) GetWebRequest(Uri)

指定した uri に対して WebRequest を作成します。Creates a WebRequest for the specified uri.

GetWebResponse(WebRequest) GetWebResponse(WebRequest) GetWebResponse(WebRequest) GetWebResponse(WebRequest)

XML Web サービス メソッドへの同期要求から応答を返します。Returns a response from a synchronous request to an XML Web service method.

(Inherited from HttpWebClientProtocol)
GetWebResponse(WebRequest, IAsyncResult) GetWebResponse(WebRequest, IAsyncResult) GetWebResponse(WebRequest, IAsyncResult) GetWebResponse(WebRequest, IAsyncResult)

XML Web サービス メソッドへの非同期要求から応答を返します。Returns a response from an asynchronous request to an XML Web service method.

(Inherited from HttpWebClientProtocol)
GetWriterForMessage(SoapClientMessage, Int32) GetWriterForMessage(SoapClientMessage, Int32) GetWriterForMessage(SoapClientMessage, Int32) GetWriterForMessage(SoapClientMessage, Int32)

XmlWriter パラメーターの Stream プロパティで初期化された SoapClientMessage を返します。Returns a XmlWriter initialized with the Stream property of the SoapClientMessage parameter.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[]) Invoke(String, Object[])

SOAP を使用して XML Web サービス メソッドを同期的に呼び出します。Invokes an XML Web service method synchronously using SOAP.

InvokeAsync(String, Object[], SendOrPostCallback) InvokeAsync(String, Object[], SendOrPostCallback) InvokeAsync(String, Object[], SendOrPostCallback) InvokeAsync(String, Object[], SendOrPostCallback)

指定されたメソッドを非同期で呼び出します。Invokes the specified method asynchronously.

InvokeAsync(String, Object[], SendOrPostCallback, Object) InvokeAsync(String, Object[], SendOrPostCallback, Object) InvokeAsync(String, Object[], SendOrPostCallback, Object) InvokeAsync(String, Object[], SendOrPostCallback, Object)

指定されたメソッドを非同期で呼び出します。Invokes the specified method asynchronously.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

Component の名前 (存在する場合) を格納する String を返します。Returns a String containing the name of the Component, if any. このメソッドはオーバーライドできません。This method should not be overridden.

(Inherited from Component)

イベント

Disposed Disposed Disposed Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されると発生します。Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

適用対象

スレッド セーフ

この型はスレッド セーフです。This type is thread safe.

こちらもご覧ください