WebServiceAttribute.Namespace WebServiceAttribute.Namespace WebServiceAttribute.Namespace WebServiceAttribute.Namespace Property

Определение

Получает или задает пространство имен XML по умолчанию для веб-службы XML.Gets or sets the default XML namespace to use for the XML Web service.

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

Значение свойства

Пространство имен XML по умолчанию для веб-службы XML.The default XML namespace to use for the XML Web service. Значение по умолчанию задается с помощью свойства DefaultNamespace.The default is specified in the DefaultNamespace property.

Примеры

В Namespace следующем примере задается значение http://www.contoso.com и Action переопределяется это пространство имен для SoapDocumentMethodAttribute свойства путем Time добавления в метод веб-службы XML.The following example sets Namespace to http://www.contoso.com and overrides that namespace for the Action property by adding a SoapDocumentMethodAttribute to the Time XML Web service method.

<%@ 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 namespaces offer a way to create names in an XML document that are identified by a Uniform Resource Identifier (URI). С помощью пространств имен XML можно однозначно идентифицировать элементы или атрибуты в XML-документе.By using XML namespaces you can uniquely identify elements or attributes in a XML document. Описание службы для веб-службы XML определяется в формате XML, а именно в языке описания веб-служб (WSDL).The service description for a XML Web service is defined in XML, specifically in Web Services Description Language (WSDL).

В описании службы для веб-службы XML используется Namespace в качестве пространства имен по умолчанию для XML-элементов, непосредственно относящихся к XML Web Service.Within the Service Description for an XML Web service, Namespace is used as the default namespace for XML elements directly pertaining to the XML Web service. Например, имя веб-службы XML и ее методы веб-службы XML относятся к пространству имен, указанному в Namespace свойстве.For example, the name of the XML Web service and its XML Web service methods pertain to the namespace specified in the Namespace property. Элементы, относящиеся к WSDL, относятся к http://schemas.xmlsoap.org/wsdl/ пространству имен.Elements that are specific to WSDL pertain to the http://schemas.xmlsoap.org/wsdl/ namespace.

Для клиентов веб-службы XML, использующих SOAP для вызова веб-службы XML, при необходимости SoapDocumentMethodAttribute можно SoapRpcMethodAttribute добавить или для вызова метода веб-службы XML.For XML Web service clients using SOAP to call an XML Web service, you can optionally add the SoapDocumentMethodAttribute or SoapRpcMethodAttribute to call an XML Web service method. Если клиент вызывает веб-службу XML, созданную с помощью ASP.NET, RequestNamespace ResponseNamespace свойства и Action являются производными от Namespace свойства по умолчанию.If the client is calling an XML Web service created using ASP.NET, the RequestNamespace, ResponseNamespace and Action properties are all derived from the Namespace property by default. Например, Time Если задано имя метода веб-службы XML Namespace и свойство класса http://www.contoso.com/, Action свойство по умолчанию http://www.contoso.com/Time имеет значение.For instance, given an XML Web service method name of Time and a Namespace property of http://www.contoso.com/, the Action property is http://www.contoso.com/Time by default. Чтобы изменить параметры по умолчанию RequestNamespaceдля ResponseNamespace, и Action для метода SoapDocumentMethodAttribute веб-службы XML, можно добавить в метод веб-службы XML.To change the default settings for RequestNamespace, ResponseNamespace, and Action for an XML Web service method, you can add a SoapDocumentMethodAttribute to the XML Web service method.

Примечание

Пространство имен XML отличается от пространства имен, в котором находится класс, в терминах Windows SDK.An XML namespace is different from the namespace the class resides in, in terms of the Windows SDK. Чтобы указать пространство имен для класса, см. раздел Ключевые слова пространства имен при C#записи в.To specify the namespace for the class, see Namespace Keywords if you writing in C#.

Применяется к

Дополнительно