HttpSimpleClientProtocol イベント
HttpSimpleClientProtocol クラス
アセンブリ: System.Web.Services (system.web.services.dll 内)

<ComVisibleAttribute(True)> _ Public MustInherit Class HttpSimpleClientProtocol Inherits HttpWebClientProtocol
[ComVisibleAttribute(true)] public ref class HttpSimpleClientProtocol abstract : public HttpWebClientProtocol

このクラスは、HTTP 経由で XML Web サービスとの通信を行う大部分の実装が、エンコーダを使用してパラメータと戻り値を共通の MIME 形式にエンコードすることを指定します。これらのエンコーダは、MimeFormatter クラスから派生します。既定では、HttpSimpleClientProtocol から派生したプロキシ クラスは、application/x-www-form-urlencoded MIME タイプおよび書式なし XML の応答を私用して、パラメータをエンコードします。カスタムの MIME フォーマッタは、HttpMethodAttribute 属性を使用して指定できますが、これをサービスの説明やプロキシの生成に統合するためのサポートは行われません。
Notes to Inheritors: このクラスをオーバーライドすると、特定のタイプの XML Web サービスに固有のメソッドを、派生クラスに導入できます。これらのメソッドは、単にパラメータをキャプチャし、サイトと通信する作業を実行する基本クラスを呼び出します。導入されたメソッドが非同期の場合は、BeginInvoke メソッドおよび EndInvoke メソッドを呼び出します。導入されたメソッドが同期の場合は、Invoke メソッドを呼び出します。通常、オーバーライドされたコンストラクタは、Url プロパティに XML Web サービス メソッドの URI を設定します。
Web サービス記述言語ツール (Wsdl.exe) は、特定のサービスの説明に対して HttpSimpleClientProtocol の派生クラスを生成します。

Wsdl.exe によって、下の Math XML Web サービス用に生成されるプロキシ クラスのコード例を次に示します。プロキシ クラスは、HttpGetClientProtocol から派生します。このクラスは、HttpSimpleClientProtocol 抽象クラスから派生します。
Option Strict On Option Explicit On Imports System Imports System.Diagnostics Imports System.Web.Services Imports System.Web.Services.Protocols Imports System.Xml.Serialization Public Class MyMath Inherits System.Web.Services.Protocols.HttpGetClientProtocol <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.HttpMethodAttribute(GetType(System.Web.Services.Protocols.XmlReturnReader), GetType(System.Web.Services.Protocols.UrlParameterWriter))> _ Public Function Add(ByVal num1 As String, ByVal num2 As String) As <System.Xml.Serialization.XmlRootAttribute("int", [Namespace]:="http://www.contoso.com/", IsNullable:=false)> Integer Return CType(Me.Invoke("Add", (Me.Url + "/Add"), New Object() {num1, num2}),Integer) End Function <System.Diagnostics.DebuggerStepThroughAttribute()> _ Public Function BeginAdd(ByVal num1 As String, ByVal num2 As String, ByVal callback As System.AsyncCallback, ByVal asyncState As Object) As System.IAsyncResult Return Me.BeginInvoke("Add", (Me.Url + "/Add"), New Object() {num1, num2}, callback, asyncState) End Function <System.Diagnostics.DebuggerStepThroughAttribute()> _ Public Function EndAdd(ByVal asyncResult As System.IAsyncResult) As Integer Return CType(Me.EndInvoke(asyncResult) ,Integer) End Function End Class
using System.Diagnostics; using System.Xml.Serialization; using System; using System.Web.Services.Protocols; using System.Web.Services; public class MyMath : System.Web.Services.Protocols.HttpGetClientProtocol { [System.Diagnostics.DebuggerStepThroughAttribute()] public MyMath() { this.Url = "http://www.contoso.com/math.asmx"; } [System.Diagnostics.DebuggerStepThroughAttribute()] [System.Web.Services.Protocols.HttpMethodAttribute(typeof(System.Web.Services.Protocols.XmlReturnReader), typeof(System.Web.Services.Protocols.UrlParameterWriter))] [return: System.Xml.Serialization.XmlRootAttribute("int", Namespace="http://www.contoso.com/", IsNullable=false)] public int Add(string num1, string num2) { return ((int)(this.Invoke("Add", (this.Url + "/Add"), new object[] {num1, num2}))); } [System.Diagnostics.DebuggerStepThroughAttribute()] public System.IAsyncResult BeginAdd(string num1, string num2, System.AsyncCallback callback, object asyncState) { return this.BeginInvoke("Add", (this.Url + "/Add"), new object[] {num1, num2}, callback, asyncState); } [System.Diagnostics.DebuggerStepThroughAttribute()] public int EndAdd(System.IAsyncResult asyncResult) { return ((int)(this.EndInvoke(asyncResult))); } }
#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; public ref class MyMath: public System::Web::Services::Protocols::HttpGetClientProtocol { public: [System::Diagnostics::DebuggerStepThroughAttribute] MyMath() { this->Url = "http://www.contoso.com/math.asmx"; } [System::Diagnostics::DebuggerStepThroughAttribute] [System::Web::Services::Protocols::HttpMethodAttribute(System::Web::Services::Protocols::XmlReturnReader::typeid , System::Web::Services::Protocols::UrlParameterWriter::typeid)] [returnvalue:System::Xml::Serialization::XmlRootAttribute("snippet1>" ,Namespace="http://www.contoso.com/",IsNullable=false)] int Add( String^ num1, String^ num2 ) { array<Object^>^temp0 = {num1,num2}; return *dynamic_cast<int^>(this->Invoke( "Add", (String::Concat( this->Url, "/Add" )), temp0 )); } [System::Diagnostics::DebuggerStepThroughAttribute] System::IAsyncResult^ BeginAdd( String^ num1, String^ num2, System::AsyncCallback^ callback, Object^ asyncState ) { array<Object^>^temp1 = {num1,num2}; return this->BeginInvoke( "Add", (String::Concat( this->Url, "/Add" )), temp1, callback, asyncState ); } [System::Diagnostics::DebuggerStepThroughAttribute] int EndAdd( System::IAsyncResult^ asyncResult ) { return *dynamic_cast<int^>(this->EndInvoke( asyncResult )); } };
import System.Diagnostics.*; import System.Xml.Serialization.*; import System.*; import System.Web.Services.Protocols.*; import System.Web.Services.*; public class MyMath extends System.Web.Services.Protocols.HttpGetClientProtocol { /** @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.HttpMethodAttribute (System.Web.Services.Protocols.XmlReturnReader.class, System.Web.Services.Protocols.UrlParameterWriter.class) */ public int Add(String num1, String num2) { return Integer.parseInt(System.Convert.ToString( this.Invoke("Add", this.get_Url() + "/Add", new Object[]{num1, num2}))); } //Add /** @attribute System.Diagnostics.DebuggerStepThroughAttribute() */ public System.IAsyncResult BeginAdd(String num1, String num2, System.AsyncCallback callback, Object asyncState) { return this.BeginInvoke("Add", this.get_Url() + "/Add", new Object[]{num1, num2}, callback, asyncState) ; } //BeginAdd /** @attribute System.Diagnostics.DebuggerStepThroughAttribute() */ public int EndAdd(System.IAsyncResult asyncResult) { return Integer.parseInt(System.Convert.ToString( this.EndInvoke(asyncResult))) ; } //EndAdd } //MyMath
前述のプロキシ クラスの作成元の Math XML Web サービスのコード例を次に示します。
Imports System.Web.Services Imports System Public Class Math <WebMethod()> _ Public Function Add(num1 As Integer, num2 As Integer)As Integer Return num1 + num2 End Function End Class
using System.Web.Services; using System; public class Math { [ WebMethod ] public int Add(int num1, int num2) { return num1+num2; } }

System.MarshalByRefObject
System.ComponentModel.Component
System.Web.Services.Protocols.WebClientProtocol
System.Web.Services.Protocols.HttpWebClientProtocol
System.Web.Services.Protocols.HttpSimpleClientProtocol
System.Web.Services.Protocols.HttpGetClientProtocol
System.Web.Services.Protocols.HttpPostClientProtocol


Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


HttpSimpleClientProtocol コンストラクタ
アセンブリ: System.Web.Services (system.web.services.dll 内)


Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


HttpSimpleClientProtocol プロパティ

名前 | 説明 | |
---|---|---|
![]() | AllowAutoRedirect | クライアントがサーバーのリダイレクトに自動的に従うかどうかを取得または設定します。 ( HttpWebClientProtocol から継承されます。) |
![]() | ClientCertificates | クライアント証明書のコレクションを取得します。 ( HttpWebClientProtocol から継承されます。) |
![]() | ConnectionGroupName | 要求に対して使用する接続グループの名前を取得または設定します。 ( WebClientProtocol から継承されます。) |
![]() | Container | Component を格納している IContainer を取得します。 ( Component から継承されます。) |
![]() | CookieContainer | cookie のコレクションを取得または設定します。 ( HttpWebClientProtocol から継承されます。) |
![]() | Credentials | XML Web サービス クライアント認証のセキュリティ資格情報を取得または設定します。 ( WebClientProtocol から継承されます。) |
![]() | EnableDecompression | この HttpWebClientProtocol の圧縮解除が有効かどうかを示す Boolean を取得または設定します。既定値は true です。 ( HttpWebClientProtocol から継承されます。) |
![]() | PreAuthenticate | 事前認証を有効にするかどうかを取得または設定します。 ( WebClientProtocol から継承されます。) |
![]() | Proxy | ファイアウォールをとおして XML Web サービス要求を行うためのプロキシ情報を取得または設定します。 ( HttpWebClientProtocol から継承されます。) |
![]() | RequestEncoding | クライアントが XML Web サービスを要求するときに使用される Encoding。 ( WebClientProtocol から継承されます。) |
![]() | Site | Component の ISite を取得または設定します。 ( Component から継承されます。) |
![]() | Timeout | 同期的な XML Web サービスの要求が完了するのを XML Web サービス クライアントが待機する時間 (ミリ秒単位) を示します。 ( WebClientProtocol から継承されます。) |
![]() | UnsafeAuthenticatedConnectionSharing | XML Web サービスをホストしている Web サービスに接続するときにクライアントが NTLM 認証を使用する場合、接続共有が有効になっているかどうかを示す値を取得または設定します。 ( HttpWebClientProtocol から継承されます。) |
![]() | Url | クライアントが要求している XML Web サービスのベース URL を取得または設定します。 ( WebClientProtocol から継承されます。) |
![]() | UseDefaultCredentials | Credentials プロパティを CredentialCache.DefaultCredentials プロパティの値に設定するかどうかを示す値を取得または設定します。 ( WebClientProtocol から継承されます。) |
![]() | UserAgent | それぞれの要求と共に送信されるユーザー エージェント ヘッダーの値を取得または設定します。 ( HttpWebClientProtocol から継承されます。) |

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

HttpSimpleClientProtocol メソッド

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

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

HttpSimpleClientProtocol メンバ
単純な HTTP-GET プロトコル バインディングおよび HTTP-POST プロトコル バインディングを使用して、XML Web サービスとの通信を行う基本クラスを表します。
HttpSimpleClientProtocol データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | AllowAutoRedirect | クライアントがサーバーのリダイレクトに自動的に従うかどうかを取得または設定します。(HttpWebClientProtocol から継承されます。) |
![]() | ClientCertificates | クライアント証明書のコレクションを取得します。(HttpWebClientProtocol から継承されます。) |
![]() | ConnectionGroupName | 要求に対して使用する接続グループの名前を取得または設定します。(WebClientProtocol から継承されます。) |
![]() | Container | Component を格納している IContainer を取得します。(Component から継承されます。) |
![]() | CookieContainer | cookie のコレクションを取得または設定します。(HttpWebClientProtocol から継承されます。) |
![]() | Credentials | XML Web サービス クライアント認証のセキュリティ資格情報を取得または設定します。(WebClientProtocol から継承されます。) |
![]() | EnableDecompression | この HttpWebClientProtocol の圧縮解除が有効かどうかを示す Boolean を取得または設定します。既定値は true です。(HttpWebClientProtocol から継承されます。) |
![]() | PreAuthenticate | 事前認証を有効にするかどうかを取得または設定します。(WebClientProtocol から継承されます。) |
![]() | Proxy | ファイアウォールをとおして XML Web サービス要求を行うためのプロキシ情報を取得または設定します。(HttpWebClientProtocol から継承されます。) |
![]() | RequestEncoding | クライアントが XML Web サービスを要求するときに使用される Encoding。(WebClientProtocol から継承されます。) |
![]() | Site | Component の ISite を取得または設定します。(Component から継承されます。) |
![]() | Timeout | 同期的な XML Web サービスの要求が完了するのを XML Web サービス クライアントが待機する時間 (ミリ秒単位) を示します。(WebClientProtocol から継承されます。) |
![]() | UnsafeAuthenticatedConnectionSharing | XML Web サービスをホストしている Web サービスに接続するときにクライアントが NTLM 認証を使用する場合、接続共有が有効になっているかどうかを示す値を取得または設定します。(HttpWebClientProtocol から継承されます。) |
![]() | Url | クライアントが要求している XML Web サービスのベース URL を取得または設定します。(WebClientProtocol から継承されます。) |
![]() | UseDefaultCredentials | Credentials プロパティを CredentialCache.DefaultCredentials プロパティの値に設定するかどうかを示す値を取得または設定します。(WebClientProtocol から継承されます。) |
![]() | UserAgent | それぞれの要求と共に送信されるユーザー エージェント ヘッダーの値を取得または設定します。(HttpWebClientProtocol から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | 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 を取得します。 (HttpWebClientProtocol から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
![]() | GetLifetimeService | 対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | InitializeLifetimeService | 対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | ToString | Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。) |

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


Weblioに収録されているすべての辞書からHttpSimpleClientProtocolを検索する場合は、下記のリンクをクリックしてください。

- HttpSimpleClientProtocolのページへのリンク