WebServiceAttribute Classe

Referência

Definição

Namespace:: System.Web.Services

Assembly:: System.Web.Services.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Usado para adicionar informações adicionais em um serviço Web XML, como uma cadeia de caracteres que descreve sua funcionalidade.

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 | System.AttributeTargets.Interface, Inherited=true)]
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

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

Public NotInheritable Class WebServiceAttribute
Inherits Attribute

Herança: Object

Attribute
WebServiceAttribute

Atributos: AttributeUsageAttribute

Exemplos

O exemplo a seguir define a Description propriedade do WebServiceAttribute namespace para "Common Server Variables" e define o namespace XML como 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

Comentários

Não WebServiceAttribute é necessário que um serviço Web XML seja publicado e executado. Você pode usar o WebServiceAttribute para especificar um nome para o serviço Web XML que não é restrito pelas regras de um identificador de runtime de linguagem comum, que é usado na descrição do serviço e na página de ajuda do serviço para o serviço Web XML.

Um serviço Web XML deve alterar seu namespace XML padrão antes de ser tornado público. Cada serviço Web XML precisa de um namespace XML exclusivo para identificá-lo para que os aplicativos cliente possam diferenciá-lo de outros serviços na Web. http://tempuri.org/ está disponível para serviços Web XML que estão em desenvolvimento, mas os serviços Web XML publicados devem usar um namespace mais permanente.

Seu serviço Web XML deve ser identificado por um namespace XML que você controla. Por exemplo, você pode usar o nome de domínio da Internet da sua empresa como parte do namespace XML. Embora muitos namespaces XML do serviço Web XML se pareçam com URLs, eles não precisam apontar para um recurso real na Web. (Namespaces XML do serviço Web XML são URIs.) Para serviços Web XML criados usando ASP.NET, o namespace XML padrão pode ser alterado usando Namespace a propriedade.

Para obter mais informações sobre como usar atributos, consulte Atributos.

Construtores

WebServiceAttribute()

Inicializa uma nova instância da classe WebServiceAttribute.

Campos

DefaultNamespace

O valor padrão para a propriedade Namespace. Este campo é constante.

Propriedades

Description	Uma mensagem descritiva para o serviço Web XML.
Name	Obtém ou define o nome do serviço Web XML.
Namespace	Obtém ou define o namespace de XML padrão a ser usado para o serviço Web XML.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface. (Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute)

Aplica-se a