Used to add additional information to an XML Web service, such as a string describing its functionality.
Assembly: System.Web.Services (in System.Web.Services.dll)
Thetype exposes the following members.
|Description||A descriptive message for the XML Web service.|
|Name||Gets or sets the name of the XML Web service.|
|Namespace||Gets or sets the default XML namespace to use for the XML Web service.|
|TypeId||When implemented in a derived class, gets a unique identifier for this Attribute. (Inherited from Attribute.)|
|Equals||Infrastructure. Returns a value that indicates whether this instance is equal to a specified object. (Inherited from Attribute.)|
|GetHashCode||Returns the hash code for this instance. (Inherited from Attribute.)|
|GetType||Gets the Type of the current instance. (Inherited from Object.)|
|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||When overridden in a derived class, returns a value that indicates whether this instance equals a specified object. (Inherited from Attribute.)|
|ToString||Returns a string that represents the current object. (Inherited from Object.)|
|_Attribute.GetIDsOfNames||Maps a set of names to a corresponding set of dispatch identifiers. (Inherited from Attribute.)|
|_Attribute.GetTypeInfo||Retrieves the type information for an object, which can be used to get the type information for an interface. (Inherited from Attribute.)|
|_Attribute.GetTypeInfoCount||Retrieves the number of type information interfaces that an object provides (either 0 or 1). (Inherited from Attribute.)|
|_Attribute.Invoke||Provides access to properties and methods exposed by an object. (Inherited from Attribute.)|
The is not required for an XML Web service to be published and executed. 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.
An XML Web service should change its default XML namespace before it is made public. 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/ is available for XML Web services that are under development, but published XML Web services should use a more permanent namespace.
Your XML Web service should be identified by a XML namespace that you control. For example, you could use your company's Internet domain name as part of the XML namespace. Although many XML Web service XML namespaces look like URLs, they need not point to an actual resource on the Web. (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 Extending Metadata Using Attributes.
The following example sets the Description property of the to " Common Server Variables " and sets the XML namespace to http://www.microsoft.com/.
<%@ 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