WebServiceAttribute.Name プロパティ

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

WebServiceAttribute.Name プロパティ

XML Web サービスの名前を取得または設定します。

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

Visual Basic (宣言)

Public Property Name As
 String

Visual Basic (使用法)

Dim instance As WebServiceAttribute
Dim value As String

value = instance.Name

instance.Name = value

C#

public string Name { get;
 set; }

C++

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

J#

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

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

JScript

public function get Name
 () : String

public function set Name
 (value : String)

プロパティ値
XML Web サービスの名前。既定値は、XML Web サービスを実装しているクラスの名前です。

解説

[サービスの説明] は、ユーザーが XML Web サービスの URL に移動し、クエリ文字列 ?WSDL を入力したときに生成されます。[サービスの説明] 内では、Name プロパティによって、XML Web サービスの XML 限定名のローカル部分が識別されます。Name プロパティは、[サービス ヘルプ ページ] に XML Web サービスの名前を表示するときにも使用されます。[サービス ヘルプ ページ] は、サービスの対象ユーザーが、XML Web サービス メソッド名とそのパラメータを指定せずに XML Web サービスの .asmx ページに移動したときに表示されます。

XML 限定名は、XML ドキュメントと同じ名前を持つ要素を明確に示すために使用されます。この名前は、名前空間または名前空間に関連付けられたプリフィックスと、ローカル部分がコロンで区切られた構成になっています。名前空間は URI 参照で構成され、[サービスの説明] に使用されます。名前空間の値は、Namespace プロパティの値です。通常、プリフィックスは URI へのエイリアスのように機能し、名前空間に関連付けられます。そのため、その名前空間を使用する後続のすべての XML 限定名は、短縮されたプリフィックスを使用できます。ローカル部分は文字またはアンダースコアで始まる文字列であり、空白を含めることはできません。したがって、[サービスの説明] で XML Web サービスを識別する XML 限定名は、次の書式になります。

Namespace : Name

XML 限定名の詳細については、http://www.w3.org/tr/rec-xml-names/ を参照してください。

使用例

XML Web サービスの Name を MyName に設定する例を次に示します。

Visual Basic

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

<WebService(Description := "Server Variables",
 _
    Namespace := "http://www.microsoft.com/",
 _
    Name := "MyName")> _
Public Class ServerVariables
    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= "ServerVariables"%>
 
 using System.Web.Services;
 
 [ WebService(Description="Server Variables",
              Namespace="http://www.microsoft.com/",
              Name="MyName")]
 public class ServerVariables: 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

参照

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