WebMethodAttribute.MessageName Propriedade

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

Valor de Propriedade

O nome usado para o método de serviço Web XML nos dados passados para e de um método de serviço Web XML. O padrão é o nome do método de serviço Web XML.

Exemplos

No exemplo abaixo, MessageName é usado para desambiguar os dois Add métodos.

<%@ 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

Observações

A MessageName propriedade pode ser usada para usar nomes de nomes de propriedades por alias. O uso mais comum da MessageName propriedade será identificar de forma única métodos polimórficos. Por defeito, MessageName está definido para o nome do método do serviço Web XML. Portanto, se um serviço Web XML contiver dois ou mais métodos de serviço Web XML com o mesmo nome, pode identificar de forma única os métodos individuais do serviço Web XML definindo um MessageName nome único dentro do serviço Web XML, sem alterar o nome do método real no código.

Quando os dados são passados para um serviço Web XML, são enviados num pedido e, quando são devolvidos, são enviados como resposta. Dentro do pedido e resposta, o nome usado para o método do serviço Web XML é a sua MessageName propriedade.

O nome da mensagem associado a um método de serviço Web XML deve ser único dentro do serviço Web XML.

Se um novo método de serviço Web XML com o mesmo nome mas parâmetros diferentes for adicionado após os clientes estarem a chamar o método original, um nome de mensagem diferente deve ser especificado para o novo método, mas o nome original deve ser mantido tal como está para garantir compatibilidade com os clientes existentes.

Ver também

• WebMethodAttribute