TextReturnReader クラス
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文解説TextReturnReader クラス、および System.Web.Services.Protocols 名前空間のその他のクラスは、HTTP-GET および HTTP-POST 操作を通じて .NET Framework の Web サービスの実装をサポートしています。Web サービスのライタとリーダーはそれぞれ、パラメータ間、Web メソッドのリターン オブジェクト間、および HTTP 要求/応答ストリーム間のシリアル化および逆シリアル化を行います。Web サービスのライタとリーダーは、トランスポートに HTTP を使用しますが、SOAP 標準を使用したメッセージの交換は行いません。
TextReturnReader クラスは、クライアント側で読み取られた非 XML テキストを Web メソッドの戻り値に実装します。戻り値を取得するために、HTTP 応答の本体にエンコードされているテキストは、クライアント プロキシ クラスの Web メソッドに適用できる属性 MatchAttribute で指定されている、正規表現のパターン一致を使用して解析されます。TextReturnReader クラスは PatternMatcher クラスを呼び出して、パターン一致を実際に実行します。
テキストのパターン一致により、Web サービスは HTML のコンテンツを XML スキーマ定義にバインドする必要のある XML ドキュメントに変換せずに取得できます。正規表現の検索対象は、text 要素の中の match XML 要素を使用して、Web サービス記述言語 (WSDL: Web Services Description Language) ドキュメントに指定されます。どちらの要素も名前空間 http://microsoft.com/wsdl/mime/textMatching/ に属します。
match 要素が WSDL ドキュメントに指定されている場合、Wsdl.exe ツールは、生成されるクライアント プロキシ クラスの対応する Web メソッドに MatchAttribute 属性を適用します。また、HTTP-GET および HTTP-POST 操作を通じて .NET Framework で実装されている Web サービスに従って、Web メソッドの戻り値を逆シリアル化する既定クラスの XmlReturnReader の代わりに、TextReturnReader を使用します。
継承階層System.Web.Services.Protocols.MimeFormatter
System.Web.Services.Protocols.MimeReturnReader
System.Web.Services.Protocols.TextReturnReader
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照TextReturnReader コンストラクタ
アセンブリ: 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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照TextReturnReader メソッド
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | CreateInstance | MimeFormatter から派生した具象クラスのインスタンスを作成し、初期化します。 ( MimeFormatter から継承されます。) |
.gif) | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| | GetInitializer | オーバーロードされます。 オーバーライドされます。 |
| | GetInitializers | オーバーロードされます。 ( MimeFormatter から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
| | Initialize | オーバーライドされます。 インスタンスを初期化します。 |
| | Read | オーバーライドされます。 HTTP 応答に格納されているテキストを解析します。 |
| | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
参照TextReturnReader メンバ
SOAP ではなく HTTP を使用して実装されている Web サービス クライアントの HTTP 応答テキストからの戻り値を読み取ります。
TextReturnReader データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタ| 名前 | 説明 | |
|---|---|---|
| | TextReturnReader |
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
| | CreateInstance | MimeFormatter から派生した具象クラスのインスタンスを作成し、初期化します。 (MimeFormatter から継承されます。) |
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
| | GetInitializer | オーバーロードされます。 オーバーライドされます。 |
| | GetInitializers | オーバーロードされます。 ( MimeFormatter から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| | Initialize | オーバーライドされます。 インスタンスを初期化します。 |
| | Read | オーバーライドされます。 HTTP 応答に格納されているテキストを解析します。 |
| | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
参照- TextReturnReaderのページへのリンク
