WebServiceAttribute.Namespace 属性

定义

命名空间:

System.Web.Services

程序集:

System.Web.Services.dll

获取或设置用于 XML Web services 的默认 XML 命名空间。

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

public string Namespace { get; set; }

member this.Namespace : string with get, set

Public Property Namespace As String

属性值

String

用于 XML Web services 的默认 XML 命名空间。 默认值在 DefaultNamespace 属性中指定。

示例

以下示例将 设置为 Namespacehttp://www.contoso.com ，并通过将 添加到 SoapDocumentMethodAttribute XML Web 服务方法来替代 属性的Time命名空间Action。

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

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

注解

XML 命名空间提供了一种在 XML 文档中创建名称的方法，这些名称由统一资源标识符 (URI) 标识。 通过使用 XML 命名空间，可以唯一标识 XML 文档中的元素或属性。 XML Web 服务的服务说明在 XML 中定义，特别是在 Web 服务描述语言 (WSDL) 中定义。

在 XML Web 服务的服务说明中， Namespace 用作与 XML Web 服务直接相关的 XML 元素的默认命名空间。 例如，XML Web 服务的名称及其 XML Web 服务方法与 属性中指定的 Namespace 命名空间相关。 特定于 WSDL 的元素与 http://schemas.xmlsoap.org/wsdl/ 命名空间相关。

对于使用 SOAP 调用 XML Web 服务的 XML Web 服务客户端，可以选择添加 SoapDocumentMethodAttribute 或 SoapRpcMethodAttribute 以调用 XML Web 服务方法。 如果客户端调用使用 ASP.NET 创建的 XML Web 服务， RequestNamespace则 默认情况下， ResponseNamespace 和 Action 属性都派生自 属性 Namespace 。 例如，如果 XML Web 服务方法名称为 ，TimeNamespace并且 属性http://www.contoso.com/Action默认为 http://www.contoso.com/Time 。 若要更改 、 ResponseNamespace和 Action XML Web 服务方法的默认设置RequestNamespace，可以将 添加到 SoapDocumentMethodAttribute XML Web 服务方法。

注意

就 Windows SDK 而言，XML 命名空间与类所在的命名空间不同。 若要指定类的命名空间，请参阅 命名空间关键字 （如果使用 C# 编写）。

另请参阅

• DefaultNamespace
• SoapDocumentMethodAttribute
• RequestNamespace
• ResponseNamespace
• Action
• SoapRpcMethodAttribute