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 transmises et retournées à partir d’une méthode de service Web XML.

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 transmises à et à partir d’une méthode de service Web XML. La valeur par défaut est le nom de la méthode de service Web XML.

Exemples

Dans l’exemple ci-dessous, MessageName est utilisé pour lever l’ambiguïté des 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 d’alias ou les noms de propriétés. L’utilisation la plus courante de la MessageName propriété consiste à 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 ou plus portant 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 dans le 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, elles sont envoyées dans une demande et lorsqu’elles sont retournées 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 dans le 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 une fois 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