WebMethodAttribute.MessageName Propiedad

Definición

Espacio de nombres:

System.Web.Services

Ensamblado:

System.Web.Services.dll

Nombre que se utiliza para el método de servicios Web XML en los datos que se pasan a un método de servicios Web XML y que se devuelven desde éste.

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

Valor de propiedad

String

Nombre que se utiliza para el método de servicios Web XML en los datos que se pasan a un método de servicios Web XML y desde éste. El valor predeterminado es el nombre del método de servicios Web XML.

Ejemplos

En el ejemplo siguiente, MessageName se usa para desambiguar los dos Add métodos.

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

Comentarios

La MessageName propiedad se puede usar para aplicar alias a los nombres de método o propiedad. El uso más común de la MessageName propiedad será identificar de forma única métodos polimórficos. De forma predeterminada, MessageName se establece en el nombre del método de servicio web XML. Por lo tanto, si un servicio web XML contiene dos o más métodos de servicio web XML con el mismo nombre, puede identificar de forma única los métodos de servicio web XML individuales estableciendo en MessageName un nombre único dentro del servicio web XML, sin cambiar el nombre del nombre real del método en el código.

Cuando se pasan datos a un servicio web XML, se envía en una solicitud y cuando se devuelve, se envía en una respuesta. Dentro de la solicitud y respuesta, el nombre usado para el método de servicio web XML es su MessageName propiedad.

El nombre del mensaje asociado a un método de servicio web XML debe ser único dentro del servicio web XML.

Si se agrega un nuevo método de servicio web XML con el mismo nombre, pero se agregan parámetros diferentes después de que los clientes llamen al método original, se debe especificar un nombre de mensaje diferente para el nuevo método, pero el nombre del mensaje original debe dejarse tal cual para garantizar la compatibilidad con los clientes existentes.

Consulte también

• WebMethodAttribute