WebMethodAttribute.MessageName Tulajdonság

Definíció

Névtér:

System.Web.Services

Szerelvény:

System.Web.Services.dll

Az XML Web service metódushoz használt név az XML-webszolgáltatás-metódusnak átadott és visszaadott adatokban.

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

Tulajdonság értéke

String

Az XML Web Service metódushoz használt név az XML-webszolgáltatás-metódusnak átadott adatokban. Az alapértelmezett érték az XML Web service metódus neve.

Példák

Az alábbi MessageName példában a két Add módszer egyértelműsítésére szolgál.

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

Megjegyzések

A MessageName tulajdonság használható alias metódushoz vagy tulajdonságnevekhez. A tulajdonság leggyakrabban a MessageName polimorf metódusok egyedi azonosítására használható. Alapértelmezés szerint MessageName az XML webszolgáltatás metódusának nevére van állítva. Ezért ha egy XML-webszolgáltatás két vagy több azonos nevű XML-webszolgáltatás-metódust tartalmaz, egyedileg azonosíthatja az egyes XML-webszolgáltatás-metódusokat úgy, hogy az MessageName XML-webszolgáltatáson belül egyedi névre állítja, anélkül, hogy módosítaná a tényleges metódus nevét a kódban.

Amikor adatokat ad át egy XML-webszolgáltatásnak, az egy kérésben lesz elküldve, és a visszaadott adatok válaszban lesznek elküldve. A kérelemben és a válaszban az XML-webszolgáltatás metódusához használt név a tulajdonsága MessageName .

Az XML-webszolgáltatás-metódushoz társított üzenetnévnek egyedinek kell lennie az XML-webszolgáltatásban.

Ha az ügyfelek az eredeti metódus meghívása után új, azonos nevű, de eltérő paraméterekkel rendelkező XML-webszolgáltatás-metódust adnak hozzá, az új metódushoz eltérő üzenetnevet kell megadni, de az eredeti üzenetnevet a meglévő ügyfelekkel való kompatibilitás biztosítása érdekében meg kell hagyni.

Lásd még

• WebMethodAttribute