Поделиться через


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
Наследование
WebServiceAttribute
Атрибуты

Примеры

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

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

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