WebServiceAttribute Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Используется для добавления дополнительных сведений в веб-службу XML, например строку, описывающую ее функциональные возможности.
public ref class WebServiceAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class WebServiceAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface)]
public sealed class WebServiceAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Class)>]
type WebServiceAttribute = class
inherit Attribute
[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface)>]
type WebServiceAttribute = class
inherit Attribute
Public NotInheritable Class WebServiceAttribute
Inherits Attribute
- Наследование
- Атрибуты
Примеры
В следующем примере свойство DescriptionWebServiceAttribute"Common Server Variables" объекта и задает для пространства имен XML значение.http://www.microsoft.com/
<%@ WebService Language="C#" Class= "ServerVariables"%>
using System;
using System.Web.Services;
[ WebService(Description="Common Server Variables",Namespace="http://www.contoso.com/")]
public class ServerVariables: WebService {
[ WebMethod(Description="Obtains the Server Computer Name",EnableSession=false)]
public string GetMachineName() {
return Server.MachineName;
}
}
<%@ WebService Language="VB" Class= "ServerVariables"%>
Imports System
Imports System.Web.Services
<WebService(Description := "Common Server Variables", _
Namespace := "http://www.contoso.com/")> _
Public Class ServerVariables
Inherits WebService
<WebMethod(Description := "Obtains the Computer Machine Name", _
EnableSession := False)> _
Public Function GetMachineName() As String
Return Server.MachineName
End Function
End Class
Комментарии
Для WebServiceAttribute публикации и выполнения веб-службы XML не требуется. Можно использовать WebServiceAttribute для указания имени веб-службы XML, которая не ограничена правилами для идентификатора среды CLR, который используется в описании службы и странице справки службы для веб-службы XML.
Веб-служба XML должна изменить пространство имен XML по умолчанию, прежде чем оно будет открыто. Для идентификации каждого веб-службы XML требуется уникальное пространство имен XML, чтобы клиентские приложения могли отличаться от других служб в Интернете. http://tempuri.org/ доступен для веб-служб XML, которые находятся в процессе разработки, но опубликованные веб-службы XML должны использовать более постоянное пространство имен.
Веб-служба XML должна быть определена пространством имен XML, которым вы управляете. Например, вы можете использовать доменное имя вашей компании в качестве части пространства имен XML. Хотя многие пространства имен XML-службы XML выглядят как URL-адреса, они не должны указывать на фактический ресурс в Интернете. (Пространства имен XML веб-службы XML являются URI.) Для веб-служб XML, созданных с помощью ASP.NET, пространство имен XML по умолчанию можно изменить с помощью Namespace свойства.
Дополнительные сведения об использовании атрибутов см. в разделе "Атрибуты".
Конструкторы
| Имя | Описание |
|---|---|
| WebServiceAttribute() |
Инициализирует новый экземпляр класса WebServiceAttribute. |
Поля
| Имя | Описание |
|---|---|
| DefaultNamespace |
Значение по умолчанию для Namespace свойства. Это поле является константой. |
Свойства
| Имя | Описание |
|---|---|
| Description |
Описательное сообщение для веб-службы XML. |
| Name |
Возвращает или задает имя веб-службы XML. |
| Namespace |
Возвращает или задает пространство имен XML по умолчанию, используемое для веб-службы XML. |
| TypeId |
При реализации в производном классе получает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute) |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute) |
| GetHashCode() |
Возвращает хэш-код для этого экземпляра. (Унаследовано от Attribute) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| IsDefaultAttribute() |
При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute) |
| Match(Object) |
При переопределении в производном классе возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Извлекает сведения о типе объекта, который можно использовать для получения сведений о типе для интерфейса. (Унаследовано от Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Предоставляет доступ к свойствам и методам, предоставляемым объектом. (Унаследовано от Attribute) |