WebServiceAttribute.Namespace プロパティ

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

WebServiceAttribute.Namespace プロパティ

XML Web サービスで使用する既定の XML 名前空間を取得または設定します。

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

Visual Basic (宣言)

Public Property Namespace
 As String

Visual Basic (使用法)

Dim instance As WebServiceAttribute
Dim value As String

value = instance.Namespace

instance.Namespace = value

C#

public string Namespace { get;
 set; }

C++

public:
property String^ Namespace {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_Namespace ()

/** @property */
public void set_Namespace (String value)

JScript

public function get Namespace
 () : String

public function set Namespace
 (value : String)

プロパティ値
XML Web サービスで使用する既定の XML 名前空間。既定値は DefaultNamespace プロパティで指定します。

解説

XML 名前空間を使用すると、URI (Uniform Resource Identifier) で識別される名前を XML ドキュメント内に作成できます。XML 名前空間を使用すると、XML ドキュメント内の要素または属性を一意に識別できます。XML Web サービスの [サービスの説明] は、XML、特に WSDL (Web Services Description Language) で定義されます。

XML Web サービスの [サービスの説明] では、XML Web サービスに直接関係する XML 要素の既定の名前空間として、Namespace が使用されます。たとえば、XML Web サービスの名前とその XML Web サービス メソッドは、Namespace プロパティで指定された名前空間に関係しています。WSDL 固有の要素は、http://schemas.xmlsoap.org/wsdl/ 名前空間に関係しています。

XML Web サービスを呼び出すために SOAP を使用した XML Web サービス クライアントの場合は、オプションで SoapDocumentMethodAttribute または SoapRpcMethodAttribute を追加して XML Web サービス メソッドを呼び出すことができます。クライアントが ASP.NET で作成された XML Web サービスを呼び出すと、既定では、RequestNamespace、ResponseNamespace、Action の各プロパティはすべて Namespace プロパティから派生します。たとえば、XML Web サービス メソッド名が Time で Namespace プロパティが http://www.contoso.com/ の場合、Action プロパティの既定値は http://www.contoso.com/time です。XML Web サービス メソッドの RequestNamespace、ResponseNamespace、および Action の既定の設定を変更するには、SoapDocumentMethodAttribute を XML Web サービス メソッドに追加します。

メモ
Microsoft .NET Framework SDK の観点では、XML 名前空間は、クラスが存在する名前空間とは異なります。C# でプログラムを記述する場合に、クラスの名前空間を指定する方法については、「名前空間キーワード (C# リファレンス)」を参照してください。

使用例

Namespace を http://www.contoso.com に設定し、Time XML Web サービス メソッドに SoapDocumentMethodAttribute を追加して Action プロパティの名前空間をオーバーライドする例を次に示します。

Visual Basic

<%@ WebService Language="VB" class=
 "ServerVariables"%>
 
Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols

<WebService(Description := "Server Variables",
 _
    Namespace := "http://www.contoso.com/")>
 _
Public Class ServerVariables
    Inherits WebService

    <SoapDocumentMethod(Action := "http://www.contoso.com/Time"),
 _
        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= "ServerVariables"%>
 
 using System;
 using System.Web.Services;
 using System.Web.Services.Protocols;
 
 [ WebService(Description="Server Variables",
 Namespace="http://www.contoso.com/")]
 public class ServerVariables: WebService {
    [ SoapDocumentMethod(Action="http://www.contoso.com/Time")]
    [ 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

参照

関連項目
WebServiceAttribute クラス
WebServiceAttribute メンバ
System.Web.Services 名前空間
DefaultNamespace
SoapDocumentMethodAttribute
RequestNamespace
ResponseNamespace
Action
SoapRpcMethodAttribute