WebMethodAttribute.MessageName Propriété

Définition

Espace de noms:

System.Web.Services

Assembly:

System.Web.Services.dll

Nom utilisé pour la méthode de service Web XML dans les données qui sont passées à cette méthode et que celle-ci retourne.

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

public string MessageName { get; set; }

member this.MessageName : string with get, set

Public Property MessageName As String

Valeur de propriété

String

Nom utilisé pour la méthode de service Web XML dans les données passées par et à une méthode de service Web XML. Le nom par défaut est celui de la méthode de service Web XML.

Exemples

Dans l’exemple ci-dessous, MessageName est utilisé pour désambiguer les deux Add méthodes.

<%@ WebService Language="C#" Class="Calculator" %>
 
 using System;
 using System.Web.Services;
 
 public class Calculator : WebService {
    // The MessageName property defaults to Add for this XML Web service method.
    [WebMethod]
    public int Add(int i, int j) {
       return i + j;
    }   
    [WebMethod(MessageName="Add2")]
    public int Add(int i, int j, int k) {
       return i + j + k;
    }   
 }

<%@ WebService Language="VB" Class="Calculator" %>

Imports System
Imports System.Web.Services

Public Class Calculator
    Inherits WebService
    
    ' The MessageName property defaults to Add for this XML Web service method.
    <WebMethod()> _
    Overloads Public Function Add(i As Integer, j As Integer) As Integer
        
        Return i + j
    End Function
    
    <WebMethod(MessageName := "Add2")> _
    Overloads Public Function Add(i As Integer, j As Integer, k As Integer) As Integer
        
        Return i + j + k
    End Function    
End Class

Remarques

La MessageName propriété peut être utilisée pour la méthode ou les noms de propriétés d’alias. L’utilisation la plus courante de la MessageName propriété consistera à identifier de manière unique les méthodes polymorphes. Par défaut, MessageName est défini sur le nom de la méthode de service Web XML. Par conséquent, si un service Web XML contient deux méthodes de service Web XML avec le même nom, vous pouvez identifier de manière unique les méthodes de service Web XML individuelles en définissant le MessageName nom sur un nom unique au sein du service Web XML, sans modifier le nom de la méthode réelle dans le code.

Lorsque les données sont transmises à un service web XML, elle est envoyée dans une demande et quand elle est retournée, elle est envoyée dans une réponse. Dans la requête et la réponse, le nom utilisé pour la méthode de service Web XML est sa MessageName propriété.

Le nom du message associé à une méthode de service Web XML doit être unique au sein du service Web XML.

Si une nouvelle méthode de service Web XML portant le même nom, mais que des paramètres différents sont ajoutés après que les clients appellent la méthode d’origine, un nom de message différent doit être spécifié pour la nouvelle méthode, mais le nom du message d’origine doit être laissé comme pour garantir la compatibilité avec les clients existants.

Voir aussi

• WebMethodAttribute