WebServiceAttribute Classe

Référence

Définition

Espace de noms:: System.Web.Services

Assembly:: System.Web.Services.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Utilisé pour ajouter des informations supplémentaires à un service Web XML ; par exemple une chaîne décrivant sa fonctionnalité.

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

Héritage: Object

Attribute
WebServiceAttribute

Attributs: AttributeUsageAttribute

Exemples

L’exemple suivant définit la Description propriété de sur "Common Server Variables"WebServiceAttribute et définit l’espace de noms XML sur 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

Remarques

Le WebServiceAttribute n’est pas nécessaire pour la publication et l’exécution d’un service Web XML. Vous pouvez utiliser pour WebServiceAttribute spécifier un nom pour le service Web XML qui n’est pas limité par les règles d’un identificateur common language runtime, qui est utilisé dans la description du service et dans la page d’aide du service pour le service Web XML.

Un service Web XML doit modifier son espace de noms XML par défaut avant de le rendre public. Chaque service Web XML a besoin d’un espace de noms XML unique pour l’identifier afin que les applications clientes puissent le distinguer des autres services sur le Web. http://tempuri.org/ est disponible pour les services Web XML en cours de développement, mais les services Web XML publiés doivent utiliser un espace de noms plus permanent.

Votre service Web XML doit être identifié par un espace de noms XML que vous contrôlez. Par exemple, vous pouvez utiliser le nom de domaine Internet de votre entreprise dans le cadre de l’espace de noms XML. Bien que de nombreux espaces de noms XML du service Web XML ressemblent à des URL, ils n’ont pas besoin de pointer vers une ressource réelle sur le web. (Les espaces de noms XML du service Web XML sont des URI.) Pour les services Web XML créés à l’aide de ASP.NET, l’espace de noms XML par défaut peut être modifié à l’aide Namespace de la propriété .

Pour plus d’informations sur l’utilisation des attributs, consultez Attributs.

Constructeurs

WebServiceAttribute()

Initialise une nouvelle instance de la classe WebServiceAttribute.

Champs

DefaultNamespace

Valeur par défaut de cette propriété Namespace. Ce champ est constant.

Propriétés

Description	Message descriptif pour le service Web XML.
Name	Obtient ou définit le nom du service Web XML.
Namespace	Obtient ou définit l'espace de noms XML par défaut à utiliser pour le service Web XML.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute)

S’applique à