WebServiceAttribute.Name Propriété

Définition

Espace de noms:

System.Web.Services

Assembly:

System.Web.Services.dll

Obtient ou définit le nom du service Web XML.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

public string Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

Valeur de propriété

String

Nom du service Web XML. La valeur par défaut est le nom de la classe implémentant ce service.

Exemples

L’exemple suivant définit Name le service MyNameWeb XML sur .

<%@ WebService Language="C#" class= "ServerVariables"%>
 
 using System.Web.Services;
 
 [ WebService(Description="Server Variables",
              Namespace="http://www.microsoft.com/",
              Name="MyName")]
 public class ServerVariables: WebService {
    [ WebMethod(Description="Returns the time as stored on the Server",
    EnableSession=false)]
    public string Time() {
       return Context.Timestamp.TimeOfDay.ToString();
    }
 }

<%@ WebService Language="VB" class= "ServerVariables"%>
 
Imports System.Web.Services

<WebService(Description := "Server Variables", _
    Namespace := "http://www.microsoft.com/", _
    Name := "MyName")> _
Public Class ServerVariables
    Inherits WebService
    
    <WebMethod(Description := "Returns the time as stored on the Server", _
        EnableSession := False)> _
    Public Function Time() As String
        
        Return Context.Timestamp.TimeOfDay.ToString()
    End Function
End Class

Remarques

La description du service est générée lorsqu’un utilisateur accède à l’URL du service Web XML et fournit une chaîne de requête de ? WSDL. Dans la description du service, la Name propriété identifie la partie locale du nom qualifié XML pour le service Web XML. La Name propriété est également utilisée pour afficher le nom du service Web XML dans la page d’aide du service. La page d’aide du service s’affiche lorsqu’un consommateur potentiel accède à la page .asmx du service Web XML sans spécifier de nom de méthode de service Web XML et de ses paramètres.

Un nom qualifié XML est utilisé pour lever l’ambiguïté des éléments portant le même nom qu’un document XML. Un nom qualifié XML se compose des deux parties suivantes séparées par un signe deux-points : espace de noms ou préfixe associé à un espace de noms et à une partie locale. L’espace de noms se compose d’une référence d’URI et, pour les besoins de la description du service, est la valeur de la Namespace propriété. En général, un préfixe, qui agit comme un alias vers un URI, est associé à l’espace de noms, afin que tous les noms qualifiés XML suivants utilisant l’espace de noms puissent utiliser le préfixe raccourci. La partie locale est une chaîne commençant par une lettre ou un trait de soulignement contenant aucun espace. Par conséquent, le nom qualifié XML identifiant un service Web XML dans la description du service est au format suivant :

Namespace : Name

Pour plus d’informations sur les noms qualifiés XML, consultez Espaces de noms dans XML 1.0.

Voir aussi

• Namespace