WebServiceAttribute WebServiceAttribute WebServiceAttribute WebServiceAttribute Class

Определение

Используется для добавления к веб-службе XML дополнительной информации, такой как строка с описанием ее функциональности.Used to add additional information to an XML Web service, such as a string describing its functionality.

public ref class WebServiceAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface, Inherited=true)]
[System.AttributeUsage(System.AttributeTargets.Class)]
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface)]
public sealed class WebServiceAttribute : Attribute
type WebServiceAttribute = class
    inherit Attribute
Public NotInheritable Class WebServiceAttribute
Inherits Attribute
Наследование
WebServiceAttributeWebServiceAttributeWebServiceAttributeWebServiceAttribute
Атрибуты

Примеры

В следующем примере Description свойству WebServiceAttribute объекта "Common Server Variables" присваивается значение и задается пространство имен http://www.microsoft.com/XML.The following example sets the Description property of the WebServiceAttribute to "Common Server Variables" and sets the XML namespace to 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.The WebServiceAttribute is not required for an XML Web service to be published and executed. Можно использовать, WebServiceAttribute чтобы указать имя для веб-службы XML, не ограниченное правилами для идентификатора среды CLR, который используется в описании службы и на странице справки службы для веб-службы XML.You can use the WebServiceAttribute to specify a name for the XML Web service that is not restricted by the rules for a common language runtime identifier, which is used in the service description and the Service help page for the XML Web service.

Веб-служба XML должна изменить свое пространство имен XML по умолчанию до того, как оно станет общедоступным.An XML Web service should change its default XML namespace before it is made public. Каждой веб-службе XML требуется уникальное пространство имен XML для их определения, чтобы клиентские приложения могли отличать его от других служб в Интернете.Each XML Web service needs a unique XML namespace to identify it so that client applications can distinguish it from other services on the Web. http://tempuri.org/доступен для веб-служб XML, которые находятся в разработке, но опубликованные веб-службы XML должны использовать более постоянное пространство имен.http://tempuri.org/ is available for XML Web services that are under development, but published XML Web services should use a more permanent namespace.

Веб-служба XML должна идентифицироваться по пространству имен XML, которое вы контролируете.Your XML Web service should be identified by a XML namespace that you control. Например, можно использовать доменное имя Организации в Интернете как часть пространства имен XML.For example, you could use your company's Internet domain name as part of the XML namespace. Хотя многие пространства имен XML веб-службы XML выглядят как URL-адреса, они не должны указывать на фактический ресурс в Интернете.Although many XML Web service XML namespaces look like URLs, they need not point to an actual resource on the Web. (Пространства имен XML веб-службы XML — это URI.) Для веб-служб XML, созданных с помощью ASP.NET, пространство имен XML по умолчанию можно изменить с помощью Namespace свойства.(XML Web service XML namespaces are URIs.) For XML Web services created using ASP.NET, the default XML namespace can be changed using Namespace property.

Дополнительные сведения об использовании атрибутов см. в разделе атрибуты.For more information about using attributes, see Attributes.

Конструкторы

WebServiceAttribute() WebServiceAttribute() WebServiceAttribute() WebServiceAttribute()

Инициализирует новый экземпляр класса WebServiceAttribute.Initializes a new instance of the WebServiceAttribute class.

Поля

DefaultNamespace DefaultNamespace DefaultNamespace DefaultNamespace

Значение по умолчанию для свойстваNamespace.The default value for the Namespace property. Это поле является константой.This field is constant.

Свойства

Description Description Description Description

Описательное сообщение для веб-службы XML.A descriptive message for the XML Web service.

Name Name Name Name

Получает или задает имя веб-службы XML.Gets or sets the name of the XML Web service.

Namespace Namespace Namespace Namespace

Получает или задает пространство имен XML по умолчанию для веб-службы XML.Gets or sets the default XML namespace to use for the XML Web service.

TypeId TypeId TypeId TypeId

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-код для данного экземпляра.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

При переопределении в производном классе показывает, является ли значение данного экземпляра значением по умолчанию для производного класса.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые могут использоваться для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

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

Дополнительно