WebMethodAttribute.MessageName Properti

Definisi

Ruang nama:

System.Web.Services

Rakitan:

System.Web.Services.dll

Nama yang digunakan untuk metode layanan Web XML dalam data yang diteruskan ke dan dikembalikan dari metode layanan 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

Nilai Properti

String

Nama yang digunakan untuk metode layanan Web XML dalam data yang diteruskan ke dan dari metode layanan Web XML. Defaultnya adalah nama metode layanan Web XML.

Contoh

Dalam contoh di bawah ini, MessageName digunakan untuk membedakan dua Add metode.

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

Keterangan

Properti MessageName dapat digunakan untuk metode alias atau nama properti. Penggunaan properti yang MessageName paling umum adalah untuk mengidentifikasi metode polimorfik secara unik. Secara default, MessageName diatur ke nama metode layanan Web XML. Oleh karena itu, jika layanan Web XML berisi dua metode layanan Web XML atau lebih dengan nama yang sama, Anda dapat mengidentifikasi metode layanan Web XML individual secara unik dengan mengatur MessageName ke nama yang unik dalam layanan Web XML, tanpa mengubah nama nama metode aktual dalam kode.

Ketika data diteruskan ke layanan Web XML, data dikirim dalam permintaan dan ketika dikembalikan, data dikirim sebagai respons. Dalam permintaan dan respons, nama yang digunakan untuk metode layanan Web XML adalah propertinya MessageName .

Nama pesan yang terkait dengan metode layanan Web XML harus unik dalam layanan Web XML.

Jika metode layanan Web XML baru dengan nama yang sama tetapi parameter yang berbeda ditambahkan setelah klien memanggil metode asli, nama pesan yang berbeda harus ditentukan untuk metode baru tetapi nama pesan asli harus dibiarkan apa adanya untuk memastikan kompatibilitas dengan klien yang ada.

Lihat juga

• WebMethodAttribute