WebMethodAttribute.MessageName-Eigenschaft

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.

Namespace: System.Web.Services
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Property MessageName As String
'Usage
Dim instance As WebMethodAttribute
Dim value As String

value = instance.MessageName

instance.MessageName = value

public string MessageName { get; set; }

public:
property String^ MessageName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_MessageName ()

/** @property */
public void set_MessageName (String value)

public function get MessageName () : String

public function set MessageName (value : String)

Eigenschaftenwert

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.

Hinweise

Mit der MessageName-Eigenschaft kann ein Alias für die Namen von Methoden und Eigenschaften vergeben werden. Die MessageName-Eigenschaft wird meist dazu verwendet, polymorphe Methoden eindeutig zu bezeichnen. Standardmäßig ist MessageName auf den Namen der XML-Webdienstmethode festgelegt. Wenn ein XML-Webdienst mehrere XML-Webdienstmethoden mit demselben Namen enthält, können Sie die einzelnen XML-Webdienstmethoden durch Festlegen des MessageName auf einen innerhalb des XML-Webdiensts eindeutigen Namen identifizieren, ohne den Methodennamen selbst im Code zu ändern.

Die an einen XML-Webdienst übergebenen Daten werden in einer Anforderung gesendet und in einer Antwort zurückgegeben. Innerhalb der Anforderung und der entsprechenden Antwort wird für den Namen der XML-Webdienstmethode ihre MessageName-Eigenschaft verwendet.

Der Name der Meldung, die der XML-Webdienstmethode zugeordnet ist, muss innerhalb des XML-Webdiensts eindeutig sein.

Wenn eine neue XML-Webdienstmethode mit demselben Namen und anderen Parametern hinzugefügt wird, nachdem Clients die ursprüngliche Methode aufrufen, sollte ein anderer Meldungsname für die neue Methode festgelegt werden. Der ursprüngliche Meldungsname sollte jedoch beibehalten werden, um die Kompatibilität mit vorhandenen Clients zu gewährleisten.

Beispiel

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

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

WebMethodAttribute-Klasse
WebMethodAttribute-Member
System.Web.Services-Namespace
WebMethodAttribute-Klasse