WebMethodAttribute.MessageName 속성

정의

네임스페이스:

System.Web.Services

어셈블리:

System.Web.Services.dll

XML Web services 메서드에 전달되고 반환되는 데이터 내의 XML Web services 메서드에 사용되는 이름입니다.

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

속성 값

String

XML Web services 메서드에 전달되고 반환되는 데이터 내의 XML Web services 메서드에 사용되는 이름입니다. 기본값은 XML Web services 메서드의 이름입니다.

예제

아래 MessageName 예제에서는 두 Add 메서드를 명확하게 구분하는 데 사용됩니다.

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

설명

이 속성은 MessageName 별칭 메서드 또는 속성 이름에 사용할 수 있습니다. 이 속성의 MessageName 가장 일반적인 용도는 다형 메서드를 고유하게 식별하는 것입니다. 기본적으로 MessageName XML 웹 서비스 메서드의 이름으로 설정됩니다. 따라서 XML 웹 서비스에 이름이 같은 두 개 이상의 XML 웹 서비스 메서드가 포함된 경우 코드에서 실제 메서드 이름의 이름을 변경하지 않고 XML 웹 서비스 내에서 고유한 이름으로 설정 MessageName 하여 개별 XML 웹 서비스 메서드를 고유하게 식별할 수 있습니다.

데이터가 XML 웹 서비스에 전달되면 요청에서 전송되고 반환될 때 응답으로 전송됩니다. 요청 및 응답 내에서 XML 웹 서비스 메서드에 사용되는 이름은 해당 MessageName 속성입니다.

XML 웹 서비스 메서드와 연결된 메시지 이름은 XML 웹 서비스 내에서 고유해야 합니다.

클라이언트가 원래 메서드를 호출한 후 이름이 같지만 매개 변수가 다른 새 XML 웹 서비스 메서드가 추가되면 새 메서드에 대해 다른 메시지 이름을 지정해야 하지만 기존 클라이언트와의 호환성을 보장하기 위해 원래 메시지 이름을 그대로 두어야 합니다.

추가 정보

• WebMethodAttribute