WebMethodAttribute.MessageName Proprietà

Definizione

Spazio dei nomi:

System.Web.Services

Assembly:

System.Web.Services.dll

Nome utilizzato per il metodo del servizio Web XML nei dati passati a e restituiti da un metodo di servizio Web 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

Valore della proprietà

String

Nome utilizzato per il metodo del servizio Web XML nei dati passati a e da un metodo di servizio Web XML. Il valore predefinito è il nome del metodo del servizio Web XML.

Esempio

Nell'esempio seguente MessageName viene usato per disambiguare i due Add metodi.

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

Commenti

La MessageName proprietà può essere utilizzata per aliasre i nomi di metodo o proprietà. L'uso più comune della proprietà consiste nell'identificare MessageName in modo univoco i metodi polimorfici. Per impostazione predefinita, MessageName è impostato sul nome del metodo del servizio Web XML. Pertanto, se un servizio Web XML contiene due o più metodi di servizio Web XML con lo stesso nome, è possibile identificare in modo univoco i singoli metodi del servizio Web XML impostando su MessageName un nome univoco all'interno del servizio Web XML, senza modificare il nome del nome effettivo del metodo nel codice.

Quando i dati vengono passati a un servizio Web XML, vengono inviati in una richiesta e quando vengono restituiti vengono inviati in una risposta. All'interno della richiesta e della risposta, il nome utilizzato per il metodo del servizio Web XML è la relativa MessageName proprietà.

Il nome del messaggio associato a un metodo di servizio Web XML deve essere univoco all'interno del servizio Web XML.

Se viene aggiunto un nuovo metodo di servizio Web XML con lo stesso nome ma parametri diversi dopo che i client chiamano il metodo originale, è necessario specificare un nome di messaggio diverso per il nuovo metodo, ma il nome del messaggio originale deve essere lasciato così come per garantire la compatibilità con i client esistenti.

Vedi anche

• WebMethodAttribute