WebServiceAttribute.Name Свойство

Определение

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

System.Web.Services

Сборка:

System.Web.Services.dll

Получает или задает имя веб-службы XML.

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

public string Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

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

String

Имя веб-службы XML. По умолчанию это имя класса, реализующего веб-службу XML.

Примеры

В следующем примере для веб-службы XML задано значение NameMyName.

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

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

Комментарии

Описание службы создается, когда пользователь переходит по URL-адресу веб-службы XML и предоставляет строку запроса ? WSDL. В описании Name службы свойство определяет локальную часть полного имени XML для веб-службы XML. Свойство Name также используется для отображения имени веб-службы XML на странице справки службы. Страница справки службы отображается, когда потенциальный потребитель переходит на страницу .asmx веб-службы XML без указания имени метода веб-службы XML и его параметров.

Полное имя XML используется для устранения неоднозначности элементов с тем же именем в XML-документе. Полное имя XML состоит из двух частей, разделенных двоеточием: пространство имен или префикс, связанный с пространством имен и локальной частью. Пространство имен состоит из ссылки на URI, а для описания службы — это значение Namespace свойства . Как правило, префикс, который действует как псевдоним универсального кода ресурса (URI), связан с пространством имен, поэтому все последующие полные имена XML, использующие пространство имен, могут использовать сокращенный префикс. Локальная часть — это строка, начинающаяся с буквы или подчеркивания, не содержащая пробелов. Таким образом, полное имя XML, определяющее веб-службу XML в описании службы, имеет следующий формат:

Namespace : Name

Дополнительные сведения о полных именах XML см. в разделе Пространства имен в XML 1.0.

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

• Namespace