WebMethodAttribute.MessageName Eigenschap

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

Waarde van eigenschap

De naam die wordt gebruikt voor de XML-webservicemethode in de gegevens die worden doorgegeven aan en van een XML-webservicemethode. De standaardwaarde is de naam van de XML-webservicemethode.

Voorbeelden

In het onderstaande MessageName voorbeeld wordt gebruikt om de twee Add methoden ondubbelzinnig te maken.

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

Opmerkingen

De MessageName eigenschap kan worden gebruikt voor aliasmethode- of eigenschapsnamen. Het meest voorkomende gebruik van de MessageName eigenschap is om polymorfe methoden uniek te identificeren. MessageName De standaardinstelling is ingesteld op de naam van de XML-webservicemethode. Als een XML-webservice dus twee of meer XML-webservicemethoden met dezelfde naam bevat, kunt u de afzonderlijke XML-webservicemethoden uniek identificeren door de MessageName op een unieke naam in de XML-webservice in te stellen, zonder de naam van de werkelijke methodenaam in code te wijzigen.

Wanneer gegevens worden doorgegeven aan een XML-webservice, worden deze verzonden in een aanvraag en wanneer ze worden geretourneerd, worden deze verzonden in een antwoord. Binnen de aanvraag en het antwoord is MessageName de naam die wordt gebruikt voor de XML-webservicemethode de eigenschap.

De berichtnaam die is gekoppeld aan een XML-webservicemethode, moet uniek zijn binnen de XML-webservice.

Als een nieuwe XML-webservicemethode met dezelfde naam maar verschillende parameters wordt toegevoegd nadat clients de oorspronkelijke methode aanroepen, moet er een andere berichtnaam worden opgegeven voor de nieuwe methode, maar moet de oorspronkelijke berichtnaam overblijven om compatibiliteit met bestaande clients te garanderen.

Zie ook

• WebMethodAttribute