WebMethodAttribute.MessageName Eigenschaft

Definition

Namespace:

System.Web.Services

Assembly:

System.Web.Services.dll

Der Name für die XML-Webdienstmethode, der in den Daten verwendet wird, die an eine XML-Webdienstmethode übergeben und von ihr zurückgegeben werden.

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

Eigenschaftswert

String

Der Name für die XML-Webdienstmethode, der in den Daten verwendet wird, die an eine XML-Webdienstmethode übergeben und von ihr zurück übergeben werden. Der Standardwert ist der Name der XML-Webdienstmethode.

Beispiele

Im folgenden Beispiel wird verwendet, MessageName um die beiden Add Methoden zu disambiguieren.

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

Hinweise

Die MessageName Eigenschaft kann zum Aliasmethoden- oder Eigenschaftsnamen verwendet werden. Die häufigste Verwendung der Eigenschaft besteht in der MessageName eindeutigen Identifizierung polymorpher Methoden. Standardmäßig MessageName wird auf den Namen der XML-Webdienstmethode festgelegt. Wenn ein XML-Webdienst zwei oder mehr XML-Webdienstmethoden mit demselben Namen enthält, können Sie daher die einzelnen XML-Webdienstmethoden eindeutig identifizieren, indem Sie den MessageName Namen für einen Namen innerhalb des XML-Webdiensts festlegen, ohne den Namen des tatsächlichen Methodennamens im Code zu ändern.

Wenn Daten an einen XML-Webdienst übergeben werden, wird er in einer Anforderung gesendet und wenn er zurückgegeben wird, wird es in einer Antwort gesendet. Innerhalb der Anforderung und Antwort ist der Name, der für die XML-Webdienstmethode verwendet wird, seine MessageName Eigenschaft.

Der nachrichtenname, der einer XML-Webdienstmethode zugeordnet ist, muss innerhalb des XML-Webdiensts eindeutig sein.

Wenn eine neue XML-Webdienstmethode mit demselben Namen, aber verschiedene Parameter hinzugefügt werden, nachdem Clients die ursprüngliche Methode aufgerufen haben, sollte ein anderer Nachrichtenname für die neue Methode angegeben werden, aber der ursprüngliche Nachrichtenname sollte nach der Kompatibilität mit vorhandenen Clients verlassen werden.

Siehe auch

• WebMethodAttribute