HttpWebClientProtocol

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

HttpWebClientProtocol イベント

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。)

参照

関連項目

HttpWebClientProtocol クラス
System.Web.Services.Protocols 名前空間
WebClientProtocol
WebRequest
SoapHttpClientProtocol
HttpGetClientProtocol クラス
HttpPostClientProtocol クラス

HttpWebClientProtocol クラス

HTTP トランスポート プロトコルを使用するすべての XML Web サービス クライアント プロキシの基本クラス。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public MustInherit Class
 HttpWebClientProtocol
    Inherits WebClientProtocol

Visual Basic (使用法)

Dim instance As HttpWebClientProtocol

C#

[ComVisibleAttribute(true)] 
public abstract class HttpWebClientProtocol
 : WebClientProtocol

C++

[ComVisibleAttribute(true)] 
public ref class HttpWebClientProtocol abstract
 : public WebClientProtocol

J#

/** @attribute ComVisibleAttribute(true) */ 
public abstract class HttpWebClientProtocol
 extends WebClientProtocol

JScript

ComVisibleAttribute(true) 
public abstract class HttpWebClientProtocol
 extends WebClientProtocol

解説

このクラスのプロパティを使用して、XML Web サービス要求および応答を送信するために使用する HTTP 要求オブジェクトの動作を制御します。このプロパティは、HttpWebRequest のプロパティに割り当てられます。

HTTP を使用して XML Web サービスと通信する場合は、XML Web サービスで使用する HttpWebClientProtocol から間接または直接に派生するプロキシ クラスを作成する必要があります。プロキシ クラスを手動で作成する代わりに、Wsdl.exe ツールを使用して、指定された XML Web サービスのサービスの説明からプロキシ クラスを作成できます。

HttpWebClientProtocol はすべてのプロキシ クラスの基本クラスであるため、そのプロパティと作成したプロキシ クラスのプロパティは同じになります。これらのプロパティは、基になるトランスポートの要求動作を制御するために役立ちます。たとえば、ファイアウォールをとおして XML Web サービスを呼び出すには、Proxy プロパティを使用します。これらの多数のプロパティは、Web 要求を行う HttpWebRequest の初期化に使用されます。

SoapHttpClientProtocol、HttpGetClientProtocol、および HttpPostClientProtocol は、HttpWebClientProtocol から直接的または間接的に派生して、それぞれ SOAP、HTTP-GET、および HTTP-POST をサポートします。

使用例

XML Web サービス (Math) を呼び出す ASP.NET Web フォームの例を次に示します。この Web フォームでは、EnterBtn_Click 関数の中で、サーバーがクライアントを他のサイトに自動的にリダイレクトできるようにします。また XML Web サービス メソッドを呼び出す前に、クライアント認証資格情報、プロキシ設定、要求のエンコーディング、および要求のタイムアウトを設定します。

Visual Basic

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Net"
 %>

<html>
    <script language="VB" runat="server">

    Sub EnterBtn_Click(Src As Object,
 E As EventArgs)
        Dim math As New
 MyMath.Math()
        
        ' Allow the server to redirect the request.
        math.AllowAutoRedirect = True
        
        ' Set the client-side credentials using the Credentials property.
        Dim credentials = New NetworkCredential("Joe",
 "password", "mydomain")
        math.Credentials = credentials
        
        ' Set the proxy server to proxyserver, set the port to 80 and
 specify to bypass
        ' the proxy server for local addresses.
        Dim proxyObject = New WebProxy("http://proxyserver:80",
 True)
        math.Proxy = proxyObject
        
        ' Set the encoding to utf-8.
        math.RequestEncoding = System.Text.Encoding.UTF8
        
        ' Set the time out to 15 seconds.
        math.Timeout = 15000
        
        Dim iTotal As Integer
 = math.Add(Convert.ToInt32(Num1.Text), _
           Convert.ToInt32(Num2.Text))
        Total.Text = "Total: " & iTotal.ToString()
    End Sub
 
    </script>
 
    <body>
       <form action="MathClient.aspx" runat=server>
           
          Enter the two numbers you want to add and
 then press the Total button.
          <p>
          Number 1: <asp:textbox id="Num1" runat=server/>
  +
          Number 2: <asp:textbox id="Num2" runat=server/>
 =
          <asp:button text="Total" Onclick="EnterBtn_Click"
 runat=server/>
          <p>
          <asp:label id="Total"  runat=server/>
          
       </form>
    </body>
 </html>
   

C#

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Net" %>

<html>
    <script language="C#" runat="server">
       void EnterBtn_Click(Object Src, EventArgs E) 
          {
             MyMath.Math math = new MyMath.Math();

             // Allow the server to redirect the request.
             math.AllowAutoRedirect = true;

             // Set the client-side credentials using the Credentials
 property.
             ICredentials credentials =
                new NetworkCredential("Joe","password"
,"mydomain");
             math.Credentials = credentials;

             // Set the proxy server to proxyserver, set the port to
 80, and specify to bypass
             // the proxy server for local addresses.
             IWebProxy proxyObject = new WebProxy("http://proxyserver:80"
,true);
             math.Proxy = proxyObject;

             // Set the encoding to utf-8.
             math.RequestEncoding = System.Text.Encoding.UTF8;

             // Set the time out to 15 seconds
             math.Timeout = 15000;

             int total = math.Add(Convert.ToInt32(Num1.Text),
                Convert.ToInt32(Num2.Text));
             Total.Text = "Total: " + total.ToString();
         }
 
    </script>
 
    <body>
       <form action="MathClient.aspx" runat=server>
           
          Enter the two numbers you want to add and then press the Total button.
          <p>
          Number 1: <asp:textbox id="Num1" runat=server/>  +
          Number 2: <asp:textbox id="Num2" runat=server/> =
          <asp:button text="Total" Onclick="EnterBtn_Click"
 runat=server/>
          <p>
          <asp:label id="Total"  runat=server/>
          
       </form>
    </body>
 </html>
   

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Web.Services.Protocols.WebClientProtocol
        System.Web.Services.Protocols.HttpWebClientProtocol
           System.Web.Services.Discovery.DiscoveryClientProtocol
           System.Web.Services.Protocols.HttpSimpleClientProtocol
           System.Web.Services.Protocols.SoapHttpClientProtocol

スレッド セーフ

このクラスのプロパティは、XML Web サービス メソッドを呼び出すたびに、WebRequest オブジェクトの新しいインスタンスにコピーされます。複数の異なるスレッドから同じ WebClientProtocol インスタンスで XML Web サービス メソッドを同時に呼び出すことはできますが、プロパティの一貫したスナップショットが WebRequest オブジェクトに転送されるようにするための同期は行われません。したがって、複数の異なるスレッドからプロパティを変更したり、メソッドの呼び出しを同時に行う必要がある場合は、XML Web サービス プロキシの別のインスタンスを使用するか、独自に同期を行う必要があります。

プラットフォーム

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

参照

関連項目
HttpWebClientProtocol メンバ
System.Web.Services.Protocols 名前空間
WebClientProtocol
WebRequest
SoapHttpClientProtocol
HttpGetClientProtocol クラス
HttpPostClientProtocol クラス

HttpWebClientProtocol コンストラクタ

HttpWebClientProtocol クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New HttpWebClientProtocol

C#

protected HttpWebClientProtocol ()

C++

protected:
HttpWebClientProtocol ()

J#

protected HttpWebClientProtocol ()

JScript

protected function HttpWebClientProtocol ()

プラットフォーム

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

参照

関連項目
HttpWebClientProtocol クラス
HttpWebClientProtocol メンバ
System.Web.Services.Protocols 名前空間

HttpWebClientProtocol プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ConnectionGroupName	要求に対して使用する接続グループの名前を取得または設定します。 ( WebClientProtocol から継承されます。)
	Container	Component を格納している IContainer を取得します。 ( Component から継承されます。)
	Credentials	XML Web サービス クライアント認証のセキュリティ資格情報を取得または設定します。 ( WebClientProtocol から継承されます。)
	PreAuthenticate	事前認証を有効にするかどうかを取得または設定します。 ( WebClientProtocol から継承されます。)
	RequestEncoding	クライアントが XML Web サービスを要求するときに使用される Encoding。 ( WebClientProtocol から継承されます。)
	Site	Component の ISite を取得または設定します。 ( Component から継承されます。)
	Timeout	同期的な XML Web サービスの要求が完了するのを XML Web サービス クライアントが待機する時間 (ミリ秒単位) を示します。 ( WebClientProtocol から継承されます。)
	Url	クライアントが要求している XML Web サービスのベース URL を取得または設定します。 ( WebClientProtocol から継承されます。)
	UseDefaultCredentials	Credentials プロパティを CredentialCache.DefaultCredentials プロパティの値に設定するかどうかを示す値を取得または設定します。 ( WebClientProtocol から継承されます。)
	UserAgent	それぞれの要求と共に送信されるユーザー エージェント ヘッダーの値を取得または設定します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。)

参照

関連項目

HttpWebClientProtocol クラス
System.Web.Services.Protocols 名前空間
WebClientProtocol
WebRequest
SoapHttpClientProtocol
HttpGetClientProtocol クラス
HttpPostClientProtocol クラス

HttpWebClientProtocol メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Abort	XML Web サービス メソッドへの要求をキャンセルします。 ( WebClientProtocol から継承されます。)
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GenerateXmlMappings	オーバーロードされます。 指定された型で公開される各 XML Web サービス メソッドの XmlMembersMapping を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 ( Component から継承されます。)

プロテクト メソッド

	名前	説明
	AddToCache	クライアント プロトコル ハンドラのインスタンスをキャッシュに追加します。 ( WebClientProtocol から継承されます。)
	CancelAsync	呼び出しが完了済みの場合を除き、XML Web サービス メソッドの非同期呼び出しをキャンセルします。
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
	GetFromCache	クライアント プロトコル ハンドラのインスタンスをキャッシュから取得します。 ( WebClientProtocol から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
	GetWebRequest	オーバーライドされます。 指定した URI に対する WebRequest を作成します。
	GetWebResponse	オーバーロードされます。 オーバーライドされます。 XML Web サービス メソッドへの要求から応答を返します。
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

関連項目

HttpWebClientProtocol クラス
System.Web.Services.Protocols 名前空間
WebClientProtocol
WebRequest
SoapHttpClientProtocol
HttpGetClientProtocol クラス
HttpPostClientProtocol クラス

HttpWebClientProtocol メンバ

HTTP トランスポート プロトコルを使用するすべての XML Web サービス クライアント プロキシの基本クラス。

HttpWebClientProtocol データ型で公開されるメンバを以下の表に示します。

プロテクト コンストラクタ

	名前	説明
	HttpWebClientProtocol	HttpWebClientProtocol クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ConnectionGroupName	要求に対して使用する接続グループの名前を取得または設定します。(WebClientProtocol から継承されます。)
	Container	Component を格納している IContainer を取得します。(Component から継承されます。)
	Credentials	XML Web サービス クライアント認証のセキュリティ資格情報を取得または設定します。(WebClientProtocol から継承されます。)
	PreAuthenticate	事前認証を有効にするかどうかを取得または設定します。(WebClientProtocol から継承されます。)
	RequestEncoding	クライアントが XML Web サービスを要求するときに使用される Encoding。(WebClientProtocol から継承されます。)
	Site	Component の ISite を取得または設定します。(Component から継承されます。)
	Timeout	同期的な XML Web サービスの要求が完了するのを XML Web サービス クライアントが待機する時間 (ミリ秒単位) を示します。(WebClientProtocol から継承されます。)
	Url	クライアントが要求している XML Web サービスのベース URL を取得または設定します。(WebClientProtocol から継承されます。)
	UseDefaultCredentials	Credentials プロパティを CredentialCache.DefaultCredentials プロパティの値に設定するかどうかを示す値を取得または設定します。(WebClientProtocol から継承されます。)
	UserAgent	それぞれの要求と共に送信されるユーザー エージェント ヘッダーの値を取得または設定します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Abort	XML Web サービス メソッドへの要求をキャンセルします。 (WebClientProtocol から継承されます。)
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GenerateXmlMappings	オーバーロードされます。 指定された型で公開される各 XML Web サービス メソッドの XmlMembersMapping を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。)

プロテクト メソッド

	名前	説明
	AddToCache	クライアント プロトコル ハンドラのインスタンスをキャッシュに追加します。 (WebClientProtocol から継承されます。)
	CancelAsync	呼び出しが完了済みの場合を除き、XML Web サービス メソッドの非同期呼び出しをキャンセルします。
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	GetFromCache	クライアント プロトコル ハンドラのインスタンスをキャッシュから取得します。 (WebClientProtocol から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
	GetWebRequest	オーバーライドされます。 指定した URI に対する WebRequest を作成します。
	GetWebResponse	オーバーロードされます。 オーバーライドされます。 XML Web サービス メソッドへの要求から応答を返します。
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。)

参照

関連項目

HttpWebClientProtocol クラス
System.Web.Services.Protocols 名前空間
WebClientProtocol
WebRequest
SoapHttpClientProtocol
HttpGetClientProtocol クラス
HttpPostClientProtocol クラス