이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

MessageParameterAttribute 클래스

 

게시 날짜: 2016년 11월

요청 및 응답 매개 변수의 이름을 제어합니다. Message 또는 메시지 계약과 함께 사용할 수 없습니다.

네임스페이스:   System.ServiceModel
어셈블리:  System.ServiceModel(System.ServiceModel.dll에 있음)

System.Object
  System.Attribute
    System.ServiceModel.MessageParameterAttribute

[AttributeUsageAttribute(AttributeTargets.Parameter | AttributeTargets.ReturnValue, 
	Inherited = false)]
public sealed class MessageParameterAttribute : Attribute

이름설명
System_CAPS_pubmethodMessageParameterAttribute()

MessageParameterAttribute 클래스의 새 인스턴스를 초기화합니다.

이름설명
System_CAPS_pubpropertyName

XML 스키마(XSD)에서 매개 변수의 이름 특성을 가져오거나 설정합니다.

System_CAPS_pubpropertyTypeId

파생 클래스에서 구현될 때 이 Attribute의 고유 식별자를 가져옵니다.(Attribute에서 상속됨)

이름설명
System_CAPS_pubmethodEquals(Object)

이 API는 제품 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. @FSHO2@이 인스턴스가 지정한 개체와 같은지를 나타내는 값을 반환합니다.(Attribute에서 상속됨)

System_CAPS_pubmethodGetHashCode()

이 인스턴스의 해시 코드를 반환합니다.(Attribute에서 상속됨)

System_CAPS_pubmethodGetType()

현재 인스턴스의 Type을 가져옵니다.(Object에서 상속됨)

System_CAPS_pubmethodIsDefaultAttribute()

파생 클래스에서 재정의된 경우 이 인스턴스 값이 파생 클래스에 대한 기본값인지 여부를 표시합니다.(Attribute에서 상속됨)

System_CAPS_pubmethodMatch(Object)

파생된 클래스에서 재정의 되 면이 인스턴스가 지정한 개체와 같은지 여부를 나타내는 값을 반환 합니다.(Attribute에서 상속됨)

System_CAPS_pubmethodToString()

현재 개체를 나타내는 문자열을 반환합니다.(Object에서 상속됨)

이름설명
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

이름 집합을 해당하는 디스패치 식별자 집합에 매핑합니다.(Attribute에서 상속됨)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

인터페이스의 형식 정보를 가져오는 데 사용할 수 있는 개체의 형식 정보를 검색합니다.(Attribute에서 상속됨)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

개체에서 제공하는 형식 정보 인터페이스의 수를 검색합니다(0 또는 1).(Attribute에서 상속됨)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

개체에서 노출하는 메서드와 속성에 대한 액세스를 제공합니다.(Attribute에서 상속됨)

매개 변수 이름이나 반환 값을 제어할 때 MessageParameterAttribute를 사용합니다. 이 특성은 매개 변수가 MessageContractAttribute 특성으로 표시된 경우 아무런 효과가 없습니다.

System_CAPS_note참고

작업 서명의 매개 변수 이름 값은 계약의 일부이며 대/소문자를 구분합니다. 로컬 매개 변수 이름과 클라이언트 응용 프로그램의 작업을 설명하는 메타데이터를 구분해야 하는 경우 이 특성을 사용합니다.

기본 SOAP 봉투 자체를 수정하지 않고 SOAP 본문 내용의 serialization을 제어하는 것추가 정보System.Runtime.Serialization.DataContractAttribute, 서비스 계약에서 데이터 전송 지정데이터 계약 사용를 참조하십시오.

메시지 계약 만들기추가 정보메시지 계약 사용을 참조하십시오.

다음 코드 예제에서는 MessageParameterAttribute를 사용하여 메타데이터에서 매개 변수의 이름과 반환 값을 설정하는 것을 보여 줍니다.

using System;
using System.Collections.Generic;
using System.ServiceModel;
using System.Text;

namespace Microsoft.WCF.Documentation
{
  [ServiceContract(Namespace="http://microsoft.wcf.documentation")]
  public interface ISampleService{
    [OperationContract]
    [return:MessageParameter(Name = "Output")]
    string SampleMethod([MessageParameter(Name = "Input")]string msg);
  }

  /*
   The preceding use of MessageParameterAttribute generates the following XSD:

<?xml version="1.0" encoding="utf-8" ?> 
  <xs:schema 
    elementFormDefault="qualified" 
    targetNamespace="http://microsoft.wcf.documentation" 
    xmlns:xs="http://www.w3.org/2001/XMLSchema" 
    xmlns:tns="http://microsoft.wcf.documentation">
    <xs:element name="SampleMethod">
      <xs:complexType>
        <xs:sequence>
          <xs:element minOccurs="0" name="Input" nillable="true" type="xs:string" /> 
        </xs:sequence>
      </xs:complexType>
    </xs:element>
    <xs:element name="SampleMethodResponse">
      <xs:complexType>
        <xs:sequence>
          <xs:element minOccurs="0" name="Output" nillable="true" type="xs:string" /> 
        </xs:sequence>
      </xs:complexType>
    </xs:element>
  </xs:schema>

   And the message sent is edited for clarity:
  <s:Body>
    <SampleMethod xmlns="http://microsoft.wcf.documentation">
      <Input>hello!</Input>
    </SampleMethod>
  </s:Body>   
   */

다음 예제에서는 앞에 나온 서비스에 대해 생성된 서비스 계약을 보여 줍니다. 이제 매개 변수의 이름은 Input입니다.

[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]
[System.ServiceModel.ServiceContractAttribute(Namespace="http://microsoft.wcf.documentation", ConfigurationName="ISampleService")]
public interface ISampleService
{

    [System.ServiceModel.OperationContractAttribute(
      Action="http://microsoft.wcf.documentation/ISampleService/SampleMethod",
      ReplyAction="http://microsoft.wcf.documentation/ISampleService/SampleMethodResponse"
    )]
    [return: System.ServiceModel.MessageParameterAttribute(Name="Output")]
    string SampleMethod(string Input);
}

유니버설 Windows 플랫폼
8 이후 사용 가능
.NET Framework
3.0 이후 사용 가능
이식 가능한 클래스 라이브러리
이식 가능한 .NET 플랫폼 에서 지원됨
Silverlight
2.0 이후 사용 가능
Windows Phone Silverlight
7.0 이후 사용 가능

이 형식의 모든 public static(Visual Basic의 공유 Visual Basic의 경우) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전이 보장되지 않습니다.

맨 위로 이동
표시: