WebServiceAttribute.Namespace Свойство

Определение

Пространство имен:

System.Web.Services

Сборка:

System.Web.Services.dll

Получает или задает пространство имен XML по умолчанию для веб-службы 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 по умолчанию для веб-службы XML. Значение по умолчанию задается с помощью свойства DefaultNamespace.

Примеры

В следующем примере задается http://www.contoso.comNamespace значение и переопределяется это пространство имен для Action свойства путем добавления SoapDocumentMethodAttribute в Time метод веб-службы XML.

<%@ 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 определяется в XML, в частности в языке WSDL.

В описании службы для веб-службы XML используется в качестве пространства имен по умолчанию для XML-элементов, Namespace непосредственно относящихся к веб-службе XML. Например, имя веб-службы XML и ее методы веб-службы XML относятся к пространству имен, указанному в свойстве Namespace . Элементы, относящиеся к WSDL, относятся к пространству http://schemas.xmlsoap.org/wsdl/ имен.

Для клиентов веб-службы XML, использующих ПРОТОКОЛ SOAP для вызова веб-службы XML, при необходимости можно добавить SoapDocumentMethodAttribute или SoapRpcMethodAttribute , чтобы вызвать метод веб-службы XML. Если клиент вызывает веб-службу XML, созданную с помощью ASP.NET, RequestNamespaceвсе свойства , ResponseNamespace и Action по умолчанию являются производными от Namespace свойства . Например, если задано имя Time метода веб-службы XML и Namespace свойство http://www.contoso.com/, Action свойство по умолчанию имеет значение http://www.contoso.com/Time . Чтобы изменить параметры по умолчанию для RequestNamespace, ResponseNamespaceи Action для метода веб-службы XML, можно добавить SoapDocumentMethodAttribute в метод веб-службы XML.

Примечание

Пространство имен XML отличается от пространства имен, в котором находится класс, с точки зрения Windows SDK. Чтобы указать пространство имен для класса, см. раздел Ключевые слова пространства имен при написании на C#.

См. также раздел

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