WebServiceAttribute Класс

Определение

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

System.Web.Services

Сборка:

System.Web.Services.dll

Используется для добавления к веб-службе XML дополнительной информации, такой как строка с описанием ее функциональности.

public ref class WebServiceAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface)]
public sealed class WebServiceAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface)>]
type WebServiceAttribute = class
    inherit Attribute

Public NotInheritable Class WebServiceAttribute
Inherits Attribute

Наследование

Object

Attribute

WebServiceAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере свойству 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)

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

• WebService
• WebMethodAttribute
• SoapDocumentMethodAttribute
• SoapDocumentServiceAttribute
• SoapRpcMethodAttribute
• SoapRpcServiceAttribute