WebServiceAttribute.Name Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает имя веб-службы 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
Значение свойства
Имя веб-службы 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 в описании службы, имеет следующий формат:
Дополнительные сведения о полных именах XML см. в разделе Пространства имен в XML 1.0.