WebMethodAttribute.MessageName Vlastnost

Definice

Obor názvů:

System.Web.Services

Sestavení:

System.Web.Services.dll

Název použitý pro metodu webové služby XML v datech předaných a vrácených z metody webové služby 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

Hodnota vlastnosti

String

Název použitý pro metodu webové služby XML v datech předaných a z metody webové služby XML. Výchozí hodnota je název metody webové služby XML.

Příklady

V následujícím MessageName příkladu se používají k nejednoznačnosti dvou Add metod.

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

Poznámky

Vlastnost MessageName lze použít k aliasu metody nebo názvů vlastností. Nejběžnějším použitím MessageName vlastnosti bude jedinečná identifikace polymorfních metod. Ve výchozím nastavení MessageName je nastaven na název metody webové služby XML. Proto pokud webová služba XML obsahuje dvě nebo více metod webové služby XML se stejným názvem, můžete jedinečně identifikovat jednotlivé metody webové služby XML nastavením MessageName na název jedinečný v rámci webové služby XML beze změny názvu skutečné metody v kódu.

Když se data předají webové službě XML, odešlou se v požadavku a po vrácení se odešlou v odpovědi. V rámci požadavku a odpovědi je název použitý pro metodu webové služby XML jeho MessageName vlastností.

Název zprávy přidružený k metodě webové služby XML musí být jedinečný v rámci webové služby XML.

Pokud se po volání původní metody přidá nová metoda webové služby XML se stejným názvem, ale po volání původní metody se klientům přidá jiný název zprávy, ale původní název zprávy by měl zůstat ponechán tak, jak je zajistit kompatibilitu s existujícími klienty.

Viz také

• WebMethodAttribute