WebServiceAttribute Classe
Définition
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 ses fonctionnalités.
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 AttributePublic NotInheritable Class WebServiceAttribute
Inherits Attribute- Héritage
- Attributs
Exemples
L’exemple suivant définit la Description propriété de la "Common Server Variables"WebServiceAttribute valeur et définit l’espace de noms http://www.microsoft.com/XML sur .
<%@ 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
Il WebServiceAttribute n’est pas nécessaire qu’un service web XML soit publié et exécuté. 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 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 d’être rendu public. Chaque service web XML a besoin d’un espace de noms XML unique pour l’identifier afin que les applications clientes puissent la distinguer d’autres services sur le Web. http://tempuri.org/ est disponible pour les services Web XML qui sont 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 de 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 de Namespace la propriété.
Pour plus d’informations sur l’utilisation d’attributs, consultez Attributs.
Constructeurs
| Nom | Description |
|---|---|
| WebServiceAttribute() |
Initialise une nouvelle instance de la classe WebServiceAttribute. |
Champs
| Nom | Description |
|---|---|
| DefaultNamespace |
Valeur par défaut de la Namespace propriété. Ce champ est constant. |
Propriétés
| Nom | Description |
|---|---|
| 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 |
En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute) |
Méthodes
| Nom | Description |
|---|---|
| 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 pour cette instance. (Hérité de Attribute) |
| GetType() |
Obtient la 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 de la classe dérivée. (Hérité de Attribute) |
| Match(Object) |
En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| _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 d’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 méthodes exposées par un objet. (Hérité de Attribute) |
