WebMethodAttribute.MessageName Özellik

Tanım

Ad Alanı:

System.Web.Services

Bütünleştirilmiş Kod:

System.Web.Services.dll

XML Web hizmeti yöntemine geçirilen ve bir XML Web hizmeti yönteminden döndürülen verilerde XML Web hizmeti yöntemi için kullanılan ad.

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

Özellik Değeri

String

XML Web hizmeti yöntemine ve xml web hizmeti yönteminden geçirilen verilerde XML Web hizmeti yöntemi için kullanılan ad. Varsayılan, XML Web hizmeti yönteminin adıdır.

Örnekler

Aşağıdaki örnekte, MessageName iki Add yöntemin belirsiz olmasını sağlamak için kullanılmıştır.

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

Açıklamalar

özelliği MessageName , diğer ad yöntemi veya özellik adları için kullanılabilir. özelliğinin MessageName en yaygın kullanımı, polimorfik yöntemleri benzersiz olarak tanımlamaktır. Varsayılan olarak, MessageName XML Web hizmeti yönteminin adına ayarlanır. Bu nedenle, bir XML Web hizmeti aynı ada sahip iki veya daha fazla XML Web hizmeti yöntemi içeriyorsa, xml web hizmeti içinde benzersiz bir ad olarak ayarlayarak MessageName , koddaki gerçek yöntem adının adını değiştirmeden tek tek XML Web hizmeti yöntemlerini benzersiz olarak tanımlayabilirsiniz.

Veriler bir XML Web hizmetine geçirildiğinde bir istekte gönderilir ve döndürülürse yanıt olarak gönderilir. İstek ve yanıt içinde, XML Web hizmeti yöntemi için kullanılan ad özelliğidir MessageName .

XML Web hizmeti yöntemiyle ilişkilendirilmiş ileti adı XML Web hizmeti içinde benzersiz olmalıdır.

İstemciler özgün yöntemi çağırdıktan sonra aynı ada ancak farklı parametrelere sahip yeni bir XML Web hizmeti yöntemi eklenirse, yeni yöntem için farklı bir ileti adı belirtilmelidir, ancak var olan istemcilerle uyumluluğu sağlamak için özgün ileti adı olduğu gibi bırakılmalıdır.

Ayrıca bkz.

• WebMethodAttribute