WebServiceAttribute Clase

Referencia

Definición

Espacio de nombres:: System.Web.Services

Ensamblado:: System.Web.Services.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Se utiliza para agregar información adicional a un servicio Web XML, como una cadena que describe su funcionalidad.

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

Herencia: Object

Attribute
WebServiceAttribute

Atributos: AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se establece la Description propiedad de en WebServiceAttribute"Common Server Variables" y se establece el espacio de nombres XML en 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

Comentarios

No WebServiceAttribute es necesario que se publique y ejecute un servicio web XML. Puede usar WebServiceAttribute para especificar un nombre para el servicio web XML que no está restringido por las reglas para un identificador de Common Language Runtime, que se usa en la descripción del servicio y la página de ayuda del servicio para el servicio web XML.

Un servicio web XML debe cambiar su espacio de nombres XML predeterminado antes de que se haga público. Cada servicio web XML necesita un espacio de nombres XML único para identificarlo para que las aplicaciones cliente puedan distinguirla de otros servicios en la Web. http://tempuri.org/ está disponible para los servicios web XML que están en desarrollo, pero los servicios web XML publicados deben usar un espacio de nombres más permanente.

El servicio web XML debe identificarse mediante un espacio de nombres XML que controle. Por ejemplo, podría usar el nombre de dominio de Internet de la empresa como parte del espacio de nombres XML. Aunque muchos espacios de nombres XML del servicio web XML tienen un aspecto similar a las direcciones URL, no necesitan apuntar a un recurso real en la Web. (Los espacios de nombres XML del servicio web XML son URI). En el caso de los servicios web XML creados mediante ASP.NET, el espacio de nombres XML predeterminado se puede cambiar mediante Namespace la propiedad .

Para obtener más información sobre el uso de atributos, vea Atributos.

Constructores

WebServiceAttribute()

Inicializa una nueva instancia de la clase WebServiceAttribute.

Campos

DefaultNamespace

Valor predeterminado para la propiedad Namespace. Este campo es constante.

Propiedades

Description	Mensaje descriptivo para el servicio Web XML.
Name	Obtiene o establece el nombre del servicio Web XML.
Namespace	Obtiene o establece el espacio de nombres XML predeterminado que se empleará en el servicio Web XML.
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). (Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Proporciona acceso a las propiedades y los métodos expuestos por un objeto. (Heredado de Attribute)

Se aplica a

Compartir vía