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