WebMethodAttribute.MessageName Свойство

Определение

Пространство имен:

System.Web.Services

Сборка:

System.Web.Services.dll

Имя, используемое для метода веб-службы XML в данных, передаваемых в метод веб-службы 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

Значение свойства

String

Имя, используемое для метода веб-службы XML в данных, передаваемых в метод веб-службы XML и возвращаемых им. По умолчанию это имя метода веб-службы XML.

Примеры

В приведенном ниже MessageName примере используется для устранения неоднозначности двух Add методов.

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

Комментарии

Свойство MessageName можно использовать для псевдонимов методов или имен свойств. Наиболее распространенное использование MessageName свойства — уникальное определение полиморфных методов. По умолчанию MessageName задается имя метода веб-службы XML. Таким образом, если веб-служба XML содержит два или более методов веб-службы XML с одинаковым именем, можно однозначно определить отдельные методы веб-службы XML, задав MessageName имя, уникальное в веб-службе XML, не изменяя имя фактического имени метода в коде.

Когда данные передаются в веб-службу XML, она отправляется в запросе и когда она возвращается, отправляется в ответе. В запросе и ответе имя, используемое для метода веб-службы XML, является его MessageName свойством.

Имя сообщения, связанное с методом веб-службы XML, должно быть уникальным в веб-службе XML.

Если новый метод веб-службы XML с тем же именем, но другие параметры добавляются после вызова исходного метода клиентами, для нового метода должно быть указано другое имя сообщения, но исходное имя сообщения должно быть оставлено так же, как и для обеспечения совместимости с существующими клиентами.

См. также раздел

• WebMethodAttribute