WebService

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

WebService イベント

パブリック イベント

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

参照

関連項目

WebService クラス
System.Web.Services 名前空間

WebService クラス

共通 ASP.NET オブジェクト (アプリケーションやセッション状態など) への直接アクセスを提供する、XML Web サービス用のオプションの基本クラスを定義します。

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

Visual Basic (宣言)

Public Class WebService
    Inherits MarshalByValueComponent

Visual Basic (使用法)

Dim instance As WebService

C#

public class WebService : MarshalByValueComponent

C++

public ref class WebService : public
 MarshalByValueComponent

J#

public class WebService extends MarshalByValueComponent

JScript

public class WebService extends
 MarshalByValueComponent

解説

共通 ASP.NET オブジェクトにアクセスする必要がない場合は、WebService から派生させずに XML Web サービスを作成できます。追加の ASP.NET オブジェクトには、Context を使用してアクセスできます。

SoapRpcMethodAttribute または SoapDocumentMethodAttribute の OneWay プロパティが true に設定されている XML Web サービス メソッドは、その HttpContext へのアクセス権がありません。そのため、該当の XML Web サービス メソッド内から WebService クラスのどのプロパティにアクセスしても null 参照 (Visual Basic では Nothing) が返されます。

使用している .NET Framework Version 1.0 XML Web サービスのメソッドに SoapRpcMethodAttribute 属性または SoapDocumentMethodAttribute 属性が適用されており、OneWay プロパティが true に設定されている場合は、静的な Current プロパティを使用して HttpContext にアクセスしないでください。HttpContext にアクセスするには、XML Web サービスのメソッドを実装するクラスを WebService から派生し、Context プロパティにアクセスします。

Topic	Location
チュートリアル : Visual Web Developer での ASP.NET Web サービスの作成と使用	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

Context プロパティを使用して、サーバーでの要求時刻を取得するために、WebService から派生して XML Web サービスを作成する例を次に示します。

Visual Basic

<%@ 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
 

C#

<%@ 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();
   }
 }
 

継承階層

System.Object
   System.ComponentModel.MarshalByValueComponent
    System.Web.Services.WebService

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
WebService メンバ
System.Web.Services 名前空間

WebService コンストラクタ

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New WebService

C#

public WebService ()

C++

public:
WebService ()

J#

public WebService ()

JScript

public function WebService ()

使用例

Visual Basic

<%@ 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
 

C#

<%@ 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();
   }
 }
 

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

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

WebService プロパティ

パブリック プロパティ

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

	名前	説明
	Application	現在の HTTP 要求に対するアプリケーション オブジェクトを取得します。
	Container	コンポーネントを格納するコンテナを取得します。 ( MarshalByValueComponent から継承されます。)
	Context	現在の要求に対する ASP.NET HttpContext を取得します。これには、HTTP サーバーが Web 要求を処理するために使用するすべての HTTP 固有のコンテキストがカプセル化されています。
	DesignMode	コンポーネントが現在デザイン モードかどうかを示す値を取得します。 ( MarshalByValueComponent から継承されます。)
	Server	現在の要求に対する HttpServerUtility を取得します。
	Session	現在の要求に対する HttpSessionState インスタンスを取得します。
	Site	コンポーネントのサイトを取得または設定します。 ( MarshalByValueComponent から継承されます。)
	SoapVersion	XML Web サービスに対して SOAP 要求を行うために使用する SOAP プロトコルのバージョンを取得します。
	User	ASP.NET サーバーの User オブジェクトを取得します。要求を実行する権限がユーザーに与えられているかどうかを認証するために使用できます。

プロテクト プロパティ

	名前	説明
	Events	コンポーネントに結び付けられているイベント ハンドラのリストを取得します。 ( MarshalByValueComponent から継承されます。)

参照

関連項目

WebService クラス
System.Web.Services 名前空間

WebService メソッド

パブリック メソッド

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

	名前	説明
	Dispose	オーバーロードされます。 MarshalByValueComponent によって使用されているリソースを解放します。 ( MarshalByValueComponent から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetService	IServiceProvider を実装しているオブジェクトを取得します。 ( MarshalByValueComponent から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	Component の名前を格納している String を返します。このメソッドはオーバーライドできません。 ( MarshalByValueComponent から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 MarshalByValueComponent によって使用されているリソースを解放します。 ( MarshalByValueComponent から継承されます。)
	Finalize	[To be supplied.] ( MarshalByValueComponent から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

WebService クラス
System.Web.Services 名前空間

WebService メンバ

共通 ASP.NET オブジェクト (アプリケーションやセッション状態など) への直接アクセスを提供する、XML Web サービス用のオプションの基本クラスを定義します。

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

パブリック コンストラクタ

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

パブリック プロパティ

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

	名前	説明
	Application	現在の HTTP 要求に対するアプリケーション オブジェクトを取得します。
	Container	コンポーネントを格納するコンテナを取得します。(MarshalByValueComponent から継承されます。)
	Context	現在の要求に対する ASP.NET HttpContext を取得します。これには、HTTP サーバーが Web 要求を処理するために使用するすべての HTTP 固有のコンテキストがカプセル化されています。
	DesignMode	コンポーネントが現在デザイン モードかどうかを示す値を取得します。(MarshalByValueComponent から継承されます。)
	Server	現在の要求に対する HttpServerUtility を取得します。
	Session	現在の要求に対する HttpSessionState インスタンスを取得します。
	Site	コンポーネントのサイトを取得または設定します。(MarshalByValueComponent から継承されます。)
	SoapVersion	XML Web サービスに対して SOAP 要求を行うために使用する SOAP プロトコルのバージョンを取得します。
	User	ASP.NET サーバーの User オブジェクトを取得します。要求を実行する権限がユーザーに与えられているかどうかを認証するために使用できます。

プロテクト プロパティ

	名前	説明
	Events	コンポーネントに結び付けられているイベント ハンドラのリストを取得します。(MarshalByValueComponent から継承されます。)

パブリック メソッド

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

	名前	説明
	Dispose	オーバーロードされます。 MarshalByValueComponent によって使用されているリソースを解放します。 (MarshalByValueComponent から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetService	IServiceProvider を実装しているオブジェクトを取得します。 (MarshalByValueComponent から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	Component の名前を格納している String を返します。このメソッドはオーバーライドできません。 (MarshalByValueComponent から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 MarshalByValueComponent によって使用されているリソースを解放します。 (MarshalByValueComponent から継承されます。)
	Finalize	[To be supplied.] (MarshalByValueComponent から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

パブリック イベント

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

参照

関連項目

WebService クラス
System.Web.Services 名前空間