WebMethodAttribute.MessageName Właściwość

Definicja

Przestrzeń nazw:

System.Web.Services

Zestaw:

System.Web.Services.dll

Nazwa używana dla metody usługi sieci Web XML w danych przekazanych do i zwróconych z metody usługi sieci 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

Wartość właściwości

String

Nazwa używana dla metody usługi sieci Web XML w danych przekazanych do i z metody usługi sieci Web XML. Wartość domyślna to nazwa metody usługi sieci Web XML.

Przykłady

W poniższym MessageName przykładzie służy do uściślania dwóch Add metod.

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

Uwagi

Właściwość MessageName może służyć do aliasu metody lub nazw właściwości. Najczęstszym zastosowaniem MessageName właściwości jest unikatowe identyfikowanie metod polimorficznych. Domyślnie MessageName jest ustawiona na nazwę metody usługi sieci Web XML. W związku z tym jeśli usługa sieci Web XML zawiera dwie lub więcej metod usługi sieci Web XML o tej samej nazwie, można jednoznacznie zidentyfikować poszczególne metody usługi sieci Web XML, ustawiając MessageName na nazwę unikatową w usłudze sieci Web XML, bez zmiany nazwy rzeczywistej nazwy metody w kodzie.

Gdy dane są przekazywane do usługi sieci Web XML, są wysyłane w żądaniu i gdy są zwracane, są wysyłane w odpowiedzi. W żądaniu i odpowiedzi nazwa używana dla metody usługi sieci Web XML to jego MessageName właściwość.

Nazwa komunikatu skojarzona z metodą usługi sieci Web XML musi być unikatowa w usłudze sieci Web XML.

Jeśli nowa metoda usługi sieci Web XML o tej samej nazwie, ale inne parametry są dodawane po wywołaniu oryginalnej metody przez klientów, należy określić inną nazwę komunikatu dla nowej metody, ale oryginalna nazwa komunikatu powinna być pozostawiona tak samo, jak w celu zapewnienia zgodności z istniejącymi klientami.

Zobacz też

• WebMethodAttribute