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ý 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 slouží k nejednoznačnosti těchto 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 názvům aliasů nebo 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, aniž byste změnili název skutečné metody v kódu.

Když se data předají webové službě XML, odešle se v požadavku a po jeho vrácení se odešle 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 asociované s metodou 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 by se měl zadat jiný název zprávy, ale původní název zprávy by měl být ponechán tak, jak je zajistit kompatibilitu se stávajícími klienty.

Viz také

• WebMethodAttribute