WebService クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
共通 ASP.NET オブジェクト (アプリケーションやセッション状態など) への直接アクセスを提供する、XML Web サービス用のオプションの基本クラスを定義します。
public ref class WebService : System::ComponentModel::MarshalByValueComponentpublic class WebService : System.ComponentModel.MarshalByValueComponenttype WebService = class
inherit MarshalByValueComponentPublic Class WebService
Inherits MarshalByValueComponent- 継承
- 派生
例
次の例では、 プロパティを使用Contextしてサーバー上の要求の時刻を取得するために、 からWebService派生した XML Web サービスを作成します。
<%@ WebService Language="C#" Class="Util" %>
using System;
using System.Web.Services;
public class Util: WebService {
[ WebMethod(Description="Returns the time as stored on the Server",
EnableSession=false)]
public string Time() {
return Context.Timestamp.TimeOfDay.ToString();
}
}
<%@ WebService Language="VB" Class="Util" %>
Imports System
Imports System.Web.Services
Public Class Util
Inherits WebService
<WebMethod(Description := "Returns the time as stored on the Server", _
EnableSession := False)> _
Public Function Time() As String
Return Context.Timestamp.TimeOfDay.ToString()
End Function
End Class
注釈
共通の ASP.NET オブジェクトにアクセスする必要がない場合でも、 から WebService派生せずに XML Web サービスを作成できます。 その他の ASP.NET オブジェクトには、 を使用して Contextアクセスできます。
の プロパティSoapRpcMethodAttributeを持つ OneWay XML Web サービス メソッドまたは SoapDocumentMethodAttribute に設定されている trueXML Web サービス メソッドは、 にHttpContextアクセスできません。 そのため、その XML Web サービス メソッド内から クラスのいずれかのプロパティに WebService アクセスすると、 が返されます null。
.NET Framework バージョン 1.0 の XML Web サービス メソッドを使用しているSoapRpcMethodAttribute場合、 または SoapDocumentMethodAttribute 属性が に設定されている 属性が にtrueOneWay設定されている場合は、静的Currentプロパティを使用して それらにHttpContextアクセスできません。 に HttpContextアクセスするには、 から XML Web サービス メソッド WebService を実装するクラスを派生させ、 プロパティに Context アクセスします。
コンストラクター
| WebService() |
WebService クラスの新しいインスタンスを初期化します。 |
プロパティ
| Application |
現在の HTTP 要求に対するアプリケーション オブジェクトを取得します。 |
| Container |
コンポーネントを格納するコンテナーを取得します。 (継承元 MarshalByValueComponent) |
| Context |
現在の要求に対する ASP.NET HttpContext を取得します。これには、HTTP サーバーが Web 要求を処理するために使用するすべての HTTP 固有のコンテキストがカプセル化されています。 |
| DesignMode |
コンポーネントが現在デザイン モードかどうかを示す値を取得します。 (継承元 MarshalByValueComponent) |
| Events |
コンポーネントに結び付けられているイベント ハンドラーのリストを取得します。 (継承元 MarshalByValueComponent) |
| Server |
現在の要求に対する HttpServerUtility を取得します。 |
| Session |
現在の要求に対する HttpSessionState インスタンスを取得します。 |
| Site |
コンポーネントのサイトを取得します。値の設定も可能です。 (継承元 MarshalByValueComponent) |
| SoapVersion |
XML Web サービスに対して SOAP 要求を行うために使用する SOAP プロトコルのバージョンを取得します。 |
| User |
ASP.NET サーバーの User オブジェクトを取得します。 要求を実行する権限がユーザーに与えられているかどうかを認証するために使用できます。 |
メソッド
| Dispose() |
MarshalByValueComponent によって使用されているすべてのリソースを解放します。 (継承元 MarshalByValueComponent) |
| Dispose(Boolean) |
MarshalByValueComponent によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。 (継承元 MarshalByValueComponent) |
| Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetService(Type) |
IServiceProvider を実装しているオブジェクトを取得します。 (継承元 MarshalByValueComponent) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
| ToString() |
Component の名前 (存在する場合) を格納する String を返します。 このメソッドはオーバーライドできません。 (継承元 MarshalByValueComponent) |
イベント
| Disposed |
コンポーネントの Disposed イベントを待機するイベント ハンドラーを追加します。 (継承元 MarshalByValueComponent) |
拡張メソッド
適用対象
.NET