WebMethodAttribute.MessageName Propriedade

Definição

Namespace:

System.Web.Services

Assembly:

System.Web.Services.dll

O nome usado para o método de serviço Web XML nos dados passados e retornados de um método de serviço 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

Valor da propriedade

String

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

Exemplos

No exemplo a seguir, 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

Comentários

A MessageName propriedade pode ser usada para nomes de propriedades ou método de alias. O uso mais comum da MessageName propriedade será identificar exclusivamente métodos polimórficos. Por padrão, MessageName é definido como o nome do método de 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, você poderá identificar exclusivamente os métodos de serviço Web XML individuais definindo como MessageName um nome exclusivo dentro do serviço Web XML, sem alterar o nome do nome do método real no código.

Quando os dados são passados para um serviço Web XML, eles são enviados em uma solicitação e, quando são retornados, são enviados em uma resposta. Dentro da solicitação e resposta, o nome usado para o método de serviço Web XML é sua MessageName propriedade.

O nome da mensagem associado a um método de serviço Web XML deve ser exclusivo no 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 chamarem o método original, um nome de mensagem diferente deverá ser especificado para o novo método, mas o nome da mensagem original deve ser deixado como está para garantir a compatibilidade com os clientes existentes.

Confira também

• WebMethodAttribute