HttpWebClientProtocol クラス

[アーティクル]
03/28/2008

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

この型のすべてのメンバの一覧については、HttpWebClientProtocol メンバを参照してください。

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

MustInherit Public Class HttpWebClientProtocol
   Inherits WebClientProtocol
[C#]
public abstract class HttpWebClientProtocol : WebClientProtocol
[C++]
public __gc __abstract class HttpWebClientProtocol : public
   WebClientProtocol
[JScript]
public abstract class HttpWebClientProtocol extends
   WebClientProtocol

スレッドセーフ

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

解説

このクラスのプロパティを使用して、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 をサポートします。

必要条件

名前空間: System.Web.Services.Protocols

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System.Web.Services (System.Web.Services.dll 内)

参照

次の方法で共有

HttpWebClientProtocol クラス

スレッドセーフ

解説

必要条件

参照

その他のリソース